SEC EDGAR

Provides access to SEC filings and XBRL financial data for all publicly traded U.S. companies via MCP.

javascript

0

GitHub Stars

javascript

Language

2 months ago

First Indexed

3 weeks ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "shawndrake2-mcp-sec-edgar": {
      "command": "node",
      "args": [
        "/path/to/sec-edgar/dist/index.js"
      ]
    }
  }
}

The SEC EDGAR MCP Server provides programmatic access to SEC filings and XBRL financial data for all publicly traded U.S. companies, enabling you to search for companies, retrieve filings, and pull financial metrics for analysis and comparisons.

How to use

You interact with this MCP server through your MCP client. Start by locating a company using its name or ticker to obtain its unique CIK, then fetch relevant filings or financial metrics. You can compare metrics across many companies to build industry benchmarks or identify trends over time.

How to install

Prerequisites: ensure you have a supported runtime for running MCP servers in your environment. This server is provided as a stdio MCP endpoint that executes a Node.js script.

Add the server configuration to your MCP client configuration using the following setup snippet. This config starts the SEC EDGAR MCP Server by invoking Node on the compiled index script.

{
  "sec-edgar": {
    "command": "node",
    "args": ["/path/to/sec-edgar/dist/index.js"],
    "env": {}
  }
}

Data availability and tools

Access a broad set of data and tools to work with SEC filings and XBRL metrics.

- Company Filings: 10-K, 10-Q, 8-K, 4, and more
- Financial Data: Revenue, assets, liabilities, cash flow, and 1000+ XBRL metrics
- Company Info: CIK, ticker, SIC code, company name
- Industry Comparisons: cross-company metric comparisons

Available tools and endpoints

Utilize the following tools to search, retrieve filings, and access financial metrics.

search_companies: Find companies by name or ticker to obtain their CIK

Common XBRL metrics and data sections

Explore commonly used XBRL metrics to analyze income, balance, and cash flow statements.

Revenues
CostOfRevenue
GrossProfit
OperatingIncomeLoss
NetIncomeLoss
EarningsPerShareBasic
EarningsPerShareDiluted

Rate limits and etiquette

The service enforces a generous request limit to ensure responsive data retrieval. Expect up to 10 requests per second, and always provide a User-Agent header when making requests.

Documentation and references

Access official SEC EDGAR API and taxonomy references to understand data structures and tagging conventions.

Security and best practices

Keep your MCP client configuration secure. Do not expose internal endpoints publicly and rotate any credentials used in your MCP environment.

Notes

If you need to start the server from an MCP client that supports stdio endpoints, include the exact path to your built script as shown in the install snippet. The server relies on the dist/index.js artifact produced by your build process.

Available tools

search_companies

Search for companies by name or ticker to find their CIK.

get_company_filings

Retrieve recent SEC filings for a given company, with optional form type and limit.

get_company_facts

Fetch all available XBRL metrics for a company, with an optional taxonomy.

get_financial_metric

Retrieve historical data for a specific XBRL metric for a company.

get_industry_metric

Get a metric across all companies for a given year and optional quarter, with optional unit and limit.

list_common_metrics

List commonly used XBRL metrics with their corresponding tags.