Tutorial: Company Ticker Search

Finance

Data source: Curated dataset (exchange listings)

Overview

Company Ticker Search wraps Curated dataset (exchange listings), handling authentication, pagination, and rate limits for you. This tutorial covers all 5 tools with working code examples you can copy and run.

Prerequisites

Sign up at https://context.gnist.ai/signup for a free API key (100 calls/day).
Choose your integration method: MCP protocol or REST API.

Connect via MCP

Add to your MCP client config (Claude Desktop, Cursor, etc.):

MCP Config

{
  "mcpServers": {
    "gnist-ticker-search": {
      "url": "https://context.gnist.ai/mcp/ticker-search/",
      "headers": {
        "Gnist-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Tools (5)

`lookup_ticker`

Look up a company by its stock ticker symbol. Returns company name, exchange, country, sector, and market cap category.

Parameter	Type	Required	Description
`ticker`	string	required	Stock ticker symbol (e.g. AAPL, 7203.T, MC.PA, EQNR.OL).

curl -X POST "https://context.gnist.ai/mcp/ticker-search/" \
  -H "Content-Type: application/json" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "lookup_ticker", "arguments": {"ticker": "AAPL"}}}'

import httpx

resp = httpx.post(
    "https://context.gnist.ai/mcp/ticker-search/",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    json={'id': 1,
 'jsonrpc': '2.0',
 'method': 'tools/call',
 'params': {'arguments': {'ticker': 'AAPL'}, 'name': 'lookup_ticker'}},
)
print(resp.json())

`search_company_tickers`

Search the company ticker database by name or symbol.

Parameter	Type	Required	Description
`query`	string	required	Search by company name or ticker symbol.
`limit`	integer	optional	Maximum results to return. (default: `20`)

curl -X POST "https://context.gnist.ai/mcp/ticker-search/" \
  -H "Content-Type: application/json" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "search_company_tickers", "arguments": {"query": "renewable energy"}}}'

import httpx

resp = httpx.post(
    "https://context.gnist.ai/mcp/ticker-search/",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    json={'id': 1,
 'jsonrpc': '2.0',
 'method': 'tools/call',
 'params': {'arguments': {'query': 'renewable energy'},
            'name': 'search_company_tickers'}},
)
print(resp.json())

`list_tickers_by_exchange`

List company tickers by stock exchange.

Parameter	Type	Required	Description
`exchange`	string	required	Stock exchange name (e.g. NYSE, NASDAQ, LSE, TSE, HKEX, OSE).
`limit`	integer	optional	Maximum results to return. (default: `50`)

curl -X POST "https://context.gnist.ai/mcp/ticker-search/" \
  -H "Content-Type: application/json" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "list_tickers_by_exchange", "arguments": {"exchange": "NYSE"}}}'

import httpx

resp = httpx.post(
    "https://context.gnist.ai/mcp/ticker-search/",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    json={'id': 1,
 'jsonrpc': '2.0',
 'method': 'tools/call',
 'params': {'arguments': {'exchange': 'NYSE'},
            'name': 'list_tickers_by_exchange'}},
)
print(resp.json())

`list_tickers_by_sector`

List company tickers by GICS sector.

Parameter	Type	Required	Description
`sector`	string	required	GICS sector (e.g. Information Technology, Financials, Health Care).
`limit`	integer	optional	Maximum results to return. (default: `50`)

curl -X POST "https://context.gnist.ai/mcp/ticker-search/" \
  -H "Content-Type: application/json" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "list_tickers_by_sector", "arguments": {"sector": "Information"}}}'

import httpx

resp = httpx.post(
    "https://context.gnist.ai/mcp/ticker-search/",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    json={'id': 1,
 'jsonrpc': '2.0',
 'method': 'tools/call',
 'params': {'arguments': {'sector': 'Information'},
            'name': 'list_tickers_by_sector'}},
)
print(resp.json())

`report_feedback`

Report a bug, feature request, or general feedback for this data source. Use this when something doesn't work as expected, when you'd like a new feature, or when you have suggestions for improvement. Args: feedback: Describe the issue or suggestion. feedback_type: One of 'bug', 'feature_request', or 'general'.

Parameter	Type	Required	Description
`feedback`	string	required
`feedback_type`	string	optional	(default: `general`)

curl -X POST "https://context.gnist.ai/mcp/ticker-search/" \
  -H "Content-Type: application/json" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "report_feedback", "arguments": {"feedback": "example"}}}'

import httpx

resp = httpx.post(
    "https://context.gnist.ai/mcp/ticker-search/",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    json={'id': 1,
 'jsonrpc': '2.0',
 'method': 'tools/call',
 'params': {'arguments': {'feedback': 'example'}, 'name': 'report_feedback'}},
)
print(resp.json())

Common Patterns

Search then retrieve
Use search_company_tickers to find items, then lookup_ticker to get full details. This two-step pattern is common for exploring data before drilling down.

Pagination
Several tools support limit, offset, or page parameters. Start with small limits during development, then increase for production queries.

FAQ

What data does Company Ticker Search provide?

Global stock ticker search — 120+ companies across 20+ exchanges worldwide. It exposes 5 tools: lookup_ticker, search_company_tickers, list_tickers_by_exchange, list_tickers_by_sector, report_feedback.

What do I need to get started?

A Gnist API key (free tier: 100 calls/day). Sign up at https://context.gnist.ai/signup.

What format does the Company Ticker Search API return?

JSON, via either MCP protocol (JSON-RPC 2.0) or REST API.