`search_symbol`

Pack: finnhub · Endpoint: https://gateway.pipeworx.io/finnhub/mcp

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

Search for stock ticker symbols by company name or keyword. Returns matching symbols with descriptions. Example: search_symbol({ query: “apple”, _apiKey: “your-key” })

Parameters

Name	Type	Required	Description
`query`	string	yes	Search query — company name or keyword, e.g. “apple”, “tesla”
`_apiKey`	string	yes	Finnhub API key

Example call

Arguments

{
  "query": "apple",
  "_apiKey": "your-finnhub-api-key"
}

curl

curl -X POST https://gateway.pipeworx.io/finnhub/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_symbol","arguments":{"query":"apple","_apiKey":"your-finnhub-api-key"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('search_symbol', {
  "query": "apple",
  "_apiKey": "your-finnhub-api-key"
});

More examples

{
  "query": "tesla",
  "_apiKey": "your-finnhub-api-key"
}

Response shape

Always returns: count, results

Field	Type	Description
`count`	integer	Number of matching results
`results`	array	List of matching symbols

Full JSON Schema

{
  "type": "object",
  "properties": {
    "count": {
      "type": "integer",
      "description": "Number of matching results"
    },
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "symbol": {
            "type": "string",
            "description": "Stock ticker symbol"
          },
          "display_symbol": {
            "type": "string",
            "description": "Display format of symbol"
          },
          "description": {
            "type": "string",
            "description": "Company description"
          },
          "type": {
            "type": "string",
            "description": "Security type (e.g. Common Stock)"
          }
        },
        "required": [
          "symbol",
          "display_symbol",
          "description",
          "type"
        ]
      },
      "description": "List of matching symbols"
    }
  },
  "required": [
    "count",
    "results"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

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

See Getting Started for client-specific install steps.

search_symbol