MCP Server

Developer

Give your AI agent direct access to real-time 8-K filing intelligence via the Model Context Protocol. Works with Claude, GPT, and any MCP-compatible client.

Overview

TransportStreamable HTTP (JSON-RPC 2.0 over HTTP POST)
Endpointhttps://api.8kintel.com/mcp
AuthAuthorization: Bearer YOUR_API_KEY
ProtocolMCP 2024-11-05
CapabilitiesTools (5 available)

Claude Desktop Configuration

Add this to your Claude Desktop claude_desktop_config.json:

claude_desktop_config.json
{
  "mcpServers": {
    "8kintel": {
      "url": "https://api.8kintel.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Available Tools

search_filings

Search SEC 8-K filings by ticker symbol, category, and date range. Returns paginated filing summaries with AI analysis.

ParameterTypeDescription
tickerstringStock ticker symbol (e.g., AAPL, TSLA)
categorystringEarnings, M&A, Leadership, Cyber, Financial, Governance, Other
limitintegerMax results (default 10, max 50)
offsetintegerPagination offset (default 0)
get_filing_summary

Get the full AI-generated summary for a specific 8-K filing, including sentiment, key signals, and exhibit analysis.

ParameterTypeDescription
filing_idstringUUID of the filing required
search_companies

Search for companies by name or ticker symbol using trigram fuzzy matching.

ParameterTypeDescription
querystringSearch query required
limitintegerMax results (default 10, max 25)
get_earnings_calendar

Get upcoming earnings dates for SEC-filing companies within a date range.

ParameterTypeDescription
daysintegerDays ahead to look (default 7, max 30)
limitintegerMax results (default 20, max 100)
offsetintegerPagination offset (default 0)
watch_ticker

Add a stock ticker to the authenticated user's watchlist to receive real-time 8-K filing alerts.

ParameterTypeDescription
tickerstringTicker to watch (e.g. AAPL) required

Example: Using with Claude

Once configured, Claude can use 8K Intel tools directly in conversation:

User

"What are the latest 8-K filings for Tesla?"

Claude

Using tool: search_filings({ticker: "TSLA"})

Here are Tesla's recent 8-K filings: The most recent filing from March 12 reports Q4 deliveries of 495,570 vehicles, beating analyst estimates by 3%. Sentiment is bullish with guidance maintained for FY2026...

JSON-RPC Protocol

The MCP server uses standard JSON-RPC 2.0. All requests are HTTP POST to the endpoint. Here's the raw request flow:

1. Initialize
POST /mcp HTTP/1.1
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {}
}

// Response:
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "protocolVersion": "2024-11-05",
    "serverInfo": { "name": "8kintel", "version": "1.0.0" },
    "capabilities": { "tools": {} }
  }
}
2. List tools
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/list",
  "params": {}
}
3. Call a tool
{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "search_filings",
    "arguments": { "ticker": "AAPL", "limit": 5 }
  }
}