MCP Tools
Available tools for querying S&P 500 company data through the MCP protocol.
Test Call
Parameters
| Name | Type | Description |
|---|---|---|
| queryrequired | string | Company symbol (e.g., AAPL) or company name (e.g., Apple) |
Returns
{
"symbol": "AAPL",
"shortName": "Apple Inc.",
"longName": "Apple Inc.",
"displayName": "Apple Inc.",
"quoteType": "EQUITY",
"address": "One Apple Park Way",
"city": "Cupertino",
"zip": "95014",
"country": "United States",
"phone": "+1-408-996-1010",
"website": "https://www.apple.com",
"irWebsite": "https://investor.apple.com",
"sector": "Technology",
"sectorKey": "TECHNOLOGY",
"industry": "Consumer Electronics",
"industryKey": "CONSUMER_ELECTRONICS",
"longBusinessSummary": "Apple Inc. designs, manufactures, and markets smartphones...",
"fullTimeEmployees": 164000
}Test Call
Parameters
| Name | Type | Description |
|---|---|---|
| queryrequired | string | Company symbol (e.g., AAPL) or company name (e.g., Apple) |
| sentimentoptional | string | Filter by sentiment (positive, negative, neutral) |
| limitoptional | number | Maximum number of results (1-100, default: 10) |
Returns
{
"symbol": "AAPL",
"news": [
{
"title": "Apple Reports Record Q4 Earnings",
"summary": "Apple Inc. announced record quarterly revenue...",
"provider": "Reuters",
"pubDate": "2024-01-15",
"sentiment": "positive",
"url": "https://example.com/news/123",
"thumbnail": "https://example.com/thumb.jpg",
"lm_level": 1,
"lm_score1": 0.85
}
]
}Test Call
Parameters
| Name | Type | Description |
|---|---|---|
| queryrequired | string | Search query (symbol, short name, or long name) |
| limitoptional | number | Maximum number of officers to return (1-50, default: 20) |
Returns
{
"symbol": "AAPL",
"officers": [
{
"name": "Mr. Timothy D. Cook",
"age": 64,
"title": "CEO & Director",
"totalPay": 16759518
},
{
"name": "Ms. Deirdre O'Brien",
"age": 58,
"title": "Senior Vice President of Retail & People",
"totalPay": 5037867
}
]
}Test Call
Parameters
| Name | Type | Description |
|---|---|---|
| queryrequired | string | Search query (symbol, short name, or long name) |
| filing_typeoptional | string | Filter by filing type (e.g., 10-K, 10-Q, 8-K, PRE 14A, DEF 14A) |
| start_dateoptional | string | Filter filings from this date (YYYY-MM-DD) |
| end_dateoptional | string | Filter filings until this date (YYYY-MM-DD) |
| limitoptional | number | Maximum number of filings to return (1-100, default: 20) |
Returns
{
"symbol": "AAPL",
"filings": [
{
"filing_date": "2026-03-20",
"filing_type": "8-K",
"title": "Corporate Changes & Voting Matters",
"edgarUrl": "https://finance.yahoo.com/sec-filing/A/0001193125-26-117614_1090872"
}
]
}Test Call
Parameters
| Name | Type | Description |
|---|---|---|
| queryrequired | string | Search query (symbol, short name, or long name) |
| itemsoptional | string[] | Exact financial items or common aliases, such as revenue, net income, EBITDA, or diluted EPS |
| start_dateoptional | string | Filter financial periods from this date (YYYY-MM-DD) |
| end_dateoptional | string | Filter financial periods until this date (YYYY-MM-DD) |
| latest_onlyoptional | boolean | Return only the latest available reporting period |
| limitoptional | number | Maximum source rows to read (1-1000, default: 500) |
Returns
{
"symbol": "AAPL",
"periods": ["2025-09-30", "2024-09-30"],
"metrics": [
{
"item": "Total Revenue",
"unit": "currency",
"values": {
"2025-09-30": 416161000000,
"2024-09-30": 391035000000
},
"changePercent": 0.0643
}
],
"derived": [
{
"item": "Net Margin",
"unit": "ratio",
"values": {
"2025-09-30": 0.2691,
"2024-09-30": 0.2397
}
}
]
}Test Call
Parameters
| Name | Type | Description |
|---|---|---|
| queryrequired | string | Company symbol (e.g., AAPL) or company name (e.g., Apple) |
| start_dateoptional | string | Filter price rows from this date (YYYY-MM-DD) |
| end_dateoptional | string | Filter price rows until this date (YYYY-MM-DD) |
| limitoptional | number | Maximum number of rows to return (1-1000, default: 100) |
Returns
{
"symbol": "AAPL",
"prices": [
{
"trade_date": "2026-04-30",
"open": 270.12,
"high": 272.88,
"low": 268.75,
"close": 271.35,
"volume": 58234100
}
],
"metadata": {
"rowCount": 1,
"latestTradeDate": "2026-04-30",
"earliestTradeDate": "2026-04-30"
}
}