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"
}
]
}