SEC Financial Report MCP Server API

MCP READY Model Context Protocol Server for SEC EDGAR Financial Data

Connect to this MCP Server

Add the following configuration to your MCP client (e.g., Claude Desktop):

{ "mcpServers": { "sec-financial-data": { "url": "https://jc321-easyreportsmcpserver.hf.space/sse" } } }

Use the URL above to connect to this MCP Server.

Available Tools (7) - Interactive Testing

Click on any tool below to expand and test it directly!

â–¶

search_company

Search for a company by name in SEC EDGAR database
Parameter Format Example
Input: "Microsoft"
Input: "Apple Inc"
Input: "Tesla"
API Request Example
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search_company",
    "arguments": {
      "company_name": "Microsoft"
    }
  }
}
Enter the full or partial company name
â–¶

advanced_search_company

Advanced search supporting name, ticker, or CIK
Parameter Format Example
By Ticker: "MSFT"
By CIK: "0000789019"
By Name: "Microsoft Corporation"
API Request Example
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "advanced_search_company",
    "arguments": {
      "company_input": "MSFT"
    }
  }
}
Enter company name, ticker symbol, or CIK code
â–¶

get_company_info

Get detailed company information by CIK code
Parameter Format Example
Microsoft: "0000789019"
Apple: "0000320193"
Tesla: "0001318605"
API Request Example
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_company_info",
    "arguments": {
      "cik": "0000789019"
    }
  }
}
10-digit CIK code (use search_company to find it)
â–¶

get_company_filings

Get list of SEC filings (10-K, 10-Q, 20-F, etc.)
Parameter Format Example
CIK: "0000789019" (Microsoft)
Form Types: Select "10-K" and "10-Q" from dropdown
Or: Leave empty to get all filing types
API Request Example
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_company_filings",
    "arguments": {
      "cik": "0000789019",
      "form_types": ["10-K", "10-Q"]
    }
  }
}
Leave empty for all types, or select specific forms (Ctrl+Click for multiple)
â–¶

get_latest_financial_data

Get the most recent financial data available
Parameter Format Example
Microsoft: "0000789019"
Apple: "0000320193"
NVIDIA: "0001045810"
API Request Example
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_latest_financial_data",
    "arguments": {
      "cik": "0000789019"
    }
  }
}
â–¶

get_financial_data

Get financial data for a specific period (annual or quarterly)
Parameter Format Example
Annual Data: CIK="0000789019", Period="2024"
Quarterly Data: CIK="0000789019", Period="2024Q3"
Format: YYYY for annual, YYYYQX for quarterly
API Request Example
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_financial_data",
    "arguments": {
      "cik": "0000789019",
      "period": "2024"
    }
  }
}
Format: YYYY for annual (e.g., 2024) or YYYYQX for quarterly (e.g., 2024Q3)
â–¶

extract_financial_metrics

Extract comprehensive financial metrics for multiple years
Parameter Format Example
3 Years: CIK="0000789019", Years=3
5 Years: CIK="0000320193", Years=5
Note: Returns annual + quarterly data (if available)
API Request Example
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "extract_financial_metrics",
    "arguments": {
      "cik": "0000789019",
      "years": 3
    }
  }
}
Number of recent years to extract (1-10)

Documentation

Visit /tools to see all available tools in JSON format.

Powered by Model Context Protocol | SEC EDGAR Data | v2.3.1