# SEV — Company Discovery from SEC Filings

> SEV — Company Discovery from SEC Filings is an MCP server for legal and government. Ask a research question and get ranked public companies with vetted SEC filing passages. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Platforms:** API, CLI
- **Website:** https://etsquare.ai/build
- **Repository:** https://github.com/etsquareai/sev-mcp
- **MCP Registry name:** io.github.ETSquareAI/sev
- **Categories:** [legal and government](https://ai-powered.com/categories/legal-and-government), [finance and payments](https://ai-powered.com/categories/finance-and-payments), [analytics and data](https://ai-powered.com/categories/analytics-and-data)
- **Listing updated:** 2026-11-14

## About

SEV searches its supported corpus of SEC filings and returns a shortlist of public companies for a natural-language question, such as which retailers disclose overseas sourcing and exposure to higher merchandise costs. Each company comes with one to three original passages from 10-K or 10-Q filings and key reported financials, so an agent reads a few paragraphs rather than whole filings. Optional previews are verbatim, and the README says rankings reflect research relevance, not investment merit.

Two tools exist. discover_sec_companies takes a required question, optional tickers or four-digit SIC codes, a filed_since date and max_companies (default 10, maximum 50); explicit filters are never relaxed and there is no hidden date default. get_sec_passage retrieves a returned passage and its neighbouring context, also readable as a sev://passages resource.

The npm package is a local stdio client of a hosted REST service and needs an API key from the ETSquare account page and Node.js 20.19 or later. Live search runs from 8:00 AM ET and may be offline overnight, searches should run one at a time, and the client waits 20 seconds per request. An evaluation allowance is shared across playground, REST and MCP, and paid plans are listed as coming soon. Empty results and omissions are possible.

## Features

- **Question-driven discovery:** Turns a research question into a ranked company shortlist.
- **Original passages:** Returns verbatim references with accession, form, filing date and section.
- **Strict filters:** Scopes by tickers or SIC codes and a filing-date cutoff without relaxing them.
- **Passage retrieval:** Fetches a passage and its adjacent context by id.
- **REST and MCP:** Offers the same search through a REST API and a stdio MCP client.

## Good for

- Find retailers disclosing overseas sourcing risk
- Shortlist companies mentioning a topic in recent filings
- Read the exact filing passage behind a claim
- Feed filing evidence into an agent's own analysis

## Install

### Claude Code (Terminal)

```sh
claude mcp add sev --env SEV_API_KEY='<SEV_API_KEY>' -- npx -y @etsquare/sev-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "sev": {
      "command": "npx",
      "args": [
        "-y",
        "@etsquare/sev-mcp"
      ],
      "env": {
        "SEV_API_KEY": "<SEV_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "sev": {
      "command": "npx",
      "args": [
        "-y",
        "@etsquare/sev-mcp"
      ],
      "env": {
        "SEV_API_KEY": "<SEV_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "sev": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@etsquare/sev-mcp"
      ],
      "env": {
        "SEV_API_KEY": "<SEV_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "sev": {
      "command": "npx",
      "args": [
        "-y",
        "@etsquare/sev-mcp"
      ],
      "env": {
        "SEV_API_KEY": "<SEV_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "sev": {
      "command": "npx",
      "args": [
        "-y",
        "@etsquare/sev-mcp"
      ],
      "env": {
        "SEV_API_KEY": "<SEV_API_KEY>"
      }
    }
  }
}
```

## Tools

- `discover_sec_companies`: Ranks companies for a research question with filing passage references
- `get_sec_passage`: Retrieves a returned passage and its neighbouring context

## FAQ

### Do I need an API key?

Yes. Create one on your ETSquare account page; it starts with sev_.

### What is a search limited by?

An evaluation allowance shared across playground, REST and MCP; a successful search, even an empty one, uses one discovery.

### Is it available all day?

Live search runs daily from 8:00 AM ET and may be offline overnight for maintenance.

### Does ranking mean investment merit?

No. Rankings describe research relevance only.

### Is this a remote server?

No. The npm package is a local stdio client of the hosted REST service.

### How do I add SEV — Company Discovery from SEC Filings to Claude Code?

Run this command in your terminal: claude mcp add sev --env SEV_API_KEY='<SEV_API_KEY>' -- npx -y @etsquare/sev-mcp

### What are the best alternatives to SEV — Company Discovery from SEC Filings?

The closest alternatives to SEV — Company Discovery from SEC Filings are beatandraise.com SEC Filings, SEC API, SEC Filings, SEC EDGAR data and SecFeed: SEC EDGAR filings.

## Where this comes from

- Description: written from the project's README and the project's website.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [beatandraise.com SEC Filings](https://ai-powered.com/mcp/beatandraise-com-sec-filings): beatandraise.com SEC Filings is a free MCP server for legal and government.
- [SEC API](https://ai-powered.com/mcp/sec-api): SEC API is a freemium MCP server for finance and payments.
- [SEC Filings](https://ai-powered.com/mcp/sec-filings-2): SEC Filings is a freemium MCP server for legal and government.
- [SEC EDGAR data](https://ai-powered.com/mcp/sec-edgar-data): SEC EDGAR data is an MCP server for legal and government.
- [SecFeed: SEC EDGAR filings](https://ai-powered.com/mcp/secfeed-sec-edgar-filings): SecFeed: SEC EDGAR filings is a freemium MCP server for legal and government.
- [x402 SEC EDGAR Lookup](https://ai-powered.com/mcp/x402-sec-edgar-lookup): x402 SEC EDGAR Lookup is a paid MCP server for legal and government.
- [SEC EDGAR Filings & XBRL Company Facts](https://ai-powered.com/mcp/sec-edgar-filings-and-xbrl-company-facts): SEC EDGAR Filings & XBRL Company Facts is a paid MCP server for legal and government.
- [SEC filings](https://ai-powered.com/mcp/sec-filings-3): SEC filings is a paid MCP server for legal and government.

---
Source: https://ai-powered.com/mcp/sev-company-discovery-from-sec-filings
