etfs
Pack: twelvedata · 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/etfs for the schema, then POST the same URL with its arguments for the data.
Twelve Data reference list of supported ETF symbols (64,000+ listings worldwide) with exchange and country metadata, paged, default 200 rows, count is the total matched. Filter by symbol (e.g. “SPY”), country or exchange. Use to discover or validate ETF tickers before querying price endpoints. A stock ticker (e.g. “AAPL”) is not an ETF and returns an empty list with empty_reason: wrong_instrument_class, use the stocks tool for those.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
symbol | string | no | Optional ETF ticker filter (e.g. “SPY”, “QQQ”, “VTI”). |
Example call
Arguments
{
"symbol": "SPY"
}
curl
curl -X POST https://gateway.pipeworx.io/twelvedata/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"etfs","arguments":{"symbol":"SPY"}}}'
TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('etfs', {
"symbol": "SPY"
});
More examples
{
"country": "United States",
"outputsize": 20
}
Response shape
| Field | Type | Description |
|---|---|---|
status | string | Response status |
code | number | Response code |
message | string | Response message |
Full JSON Schema
{
"type": "object",
"properties": {
"status": {
"type": "string",
"description": "Response status"
},
"code": {
"type": "number",
"description": "Response code"
},
"message": {
"type": "string",
"description": "Response message"
}
}
}
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 twelvedata pack
{
"mcpServers": {
"twelvedata": {
"url": "https://gateway.pipeworx.io/twelvedata/mcp"
}
}
}
See Getting Started for client-specific install steps.