`index_constituents`

Pack: index-constituents · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/index_constituents for the schema, then POST the same URL with its arguments for the data.

Current constituents of a major US or developed-markets equity index — ticker, name, GICS sector, and weight — sourced from the matching iShares index-tracking ETF’s daily holdings file (the closest free, point-in-time proxy for official index membership and weights; S&P/Russell do not publish those for free). Answers “what’s in the S&P 500 right now”, “top holdings of the Russell 2000 by weight”, “which sectors make up the S&P MidCap 400”. Cash, collateral and futures positions the ETF holds are excluded here — use ishares_etf_holdings for those.

Parameters

Name	Type	Required	Description
`index`	string	yes	Which index. One of: ${SUPPORTED_INDEXES}.
`limit`	number	no	Max rows to return, sorted by weight descending (default ${DEFAULT_LIMIT}, max ${MAX_LIMIT} — pass the max to get the full index in one call).
`offset`	number	no	Rows to skip, for paging past `limit` (default 0).
`sector`	string	no	Optional GICS sector filter, case-insensitive substring match (e.g. “Health Care”, “Energy”).

Example call

Arguments

{
  "index": "sp500",
  "limit": 600
}

curl

curl -X POST https://gateway.pipeworx.io/index-constituents/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"index_constituents","arguments":{"index":"sp500","limit":600}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('index_constituents', {
  "index": "sp500",
  "limit": 600
});

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://pipeworx.io/mcp"
    }
  }
}

Connect to just the index-constituents pack

{
  "mcpServers": {
    "index-constituents": {
      "url": "https://gateway.pipeworx.io/index-constituents/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

index_constituents