SEV — Company Discovery from SEC Filings
Ask a research question and get ranked public companies with vetted SEC filing passages
- Platforms
- API, CLI
- Runs
- Locally
- Version
- 0.1.7
- Listing updated
- 5 days ago
Similar MCP servers
About SEV — Company Discovery from SEC Filings
SEV — Company Discovery from SEC Filings is an MCP server for legal and government. It runs locally on your machine and is started by your AI client.
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.
Install
Run in a terminal
claude mcp add sev --env SEV_API_KEY='<SEV_API_KEY>' -- npx -y @etsquare/sev-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"sev": {
"command": "npx",
"args": [
"-y",
"@etsquare/sev-mcp"
],
"env": {
"SEV_API_KEY": "<SEV_API_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"sev": {
"command": "npx",
"args": [
"-y",
"@etsquare/sev-mcp"
],
"env": {
"SEV_API_KEY": "<SEV_API_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"sev": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@etsquare/sev-mcp"
],
"env": {
"SEV_API_KEY": "<SEV_API_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"sev": {
"command": "npx",
"args": [
"-y",
"@etsquare/sev-mcp"
],
"env": {
"SEV_API_KEY": "<SEV_API_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"sev": {
"command": "npx",
"args": [
"-y",
"@etsquare/sev-mcp"
],
"env": {
"SEV_API_KEY": "<SEV_API_KEY>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
SEV_API_KEYYour SEV API key from https://etsquare.ai/account (it starts with sev_).Required
Tools this server provides (2)
Taken from the project documentation; the running server may differ.
- discover_sec_companies
- Ranks companies for a research question with filing passage references
- get_sec_passage
- Retrieves a returned passage and its neighbouring context
What it does
- 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
Pricing
Pricing unknown
Evaluation allowance per account; paid plans coming soon, prices not published
Prices change. Check etsquare.ai before you buy.
SEV — Company Discovery from SEC Filings 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.