Finance
Data source: Curated dataset (S&P Dow Jones Indices)
MCP Protocol
Endpoint
https://context.gnist.ai/mcp/sp500/
claude_desktop_config.json
{
"mcpServers": {
"gnist-sp500": {
"url": "https://context.gnist.ai/mcp/sp500/",
"headers": {
"Gnist-API-Key": "YOUR_API_KEY"
}
}
}
}
Shell
curl -X POST "https://context.gnist.ai/mcp/sp500/" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "Gnist-API-Key: YOUR_API_KEY" \
-d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "get_sp500_company", "arguments": {"ticker": "example"}}}'
REST API
API Root
https://context.gnist.ai/rest/sp500/
4 endpoints available:
GET /rest/sp500/get_sp500_companyGET /rest/sp500/search_sp500_companiesGET /rest/sp500/list_sp500_by_sectorGET /rest/sp500/report_feedback
Shell
curl "https://context.gnist.ai/rest/sp500/get_sp500_company?ticker=example" \ -H "Gnist-API-Key: YOUR_API_KEY"
Python
import httpx
resp = httpx.get(
"https://context.gnist.ai/rest/sp500/get_sp500_company",
headers={"Gnist-API-Key": "YOUR_API_KEY"},
params={
"ticker": "example"
},
)
print(resp.json())
Command Line
Command
gc sp500
CLI documentation will be available when the GnistAI SDK is published.
Install
pip install gnistai
Available Tools (4)
get_sp500_companyGet detailed information about an S&P 500 company by ticker symbol.
| Parameter | Type | Required | Description |
|---|---|---|---|
ticker | string | required | Stock ticker symbol (e.g. AAPL, MSFT, GOOGL). |
search_sp500_companiesSearch the S&P 500 companies database.
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | required | Search by company name or ticker symbol. |
limit | integer | optional | Maximum results to return. (default: 20) |
list_sp500_by_sectorList S&P 500 companies by GICS sector.
| Parameter | Type | Required | Description |
|---|---|---|---|
sector | string | required | GICS sector (e.g. Information Technology, Health Care, Financials). |
limit | integer | optional | Maximum results to return. (default: 50) |
report_feedbackReport a bug, feature request, or general feedback for this data source.
| Parameter | Type | Required | Description |
|---|---|---|---|
feedback | string | required | |
feedback_type | string | optional | (default: "general") |