ETSquare / BuildPUBLIC REFERENCE
02 / BUILD

Discovery, in your workflow.

Find relevant companies and original SEC filing passages from your app or AI agent.

Create an API key in Account & API keys. Playground, REST, and MCP share your account allowance.
REST APIMCP setup
REST / SHELL
curl -X POST "https://etsquare.ai/v1/sec/discover-companies" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $SEV_API_KEY" \
  -d '{
  "question": "Which public retailers disclose overseas sourcing arrangements and exposure to higher merchandise costs?",
  "max_companies": 10
}'

Use your API key to authenticate requests. Keep it private.

Retrieve the original source

SOURCE RETRIEVAL
curl "https://etsquare.ai/v1/sec/passages/{passage_id}" -H "Authorization: Bearer $SEV_API_KEY"
A SMALL CONTRACT

01Ask a question

Send a natural-language research question, with optional company scope and filing-date cutoff.

02Receive the shortlist

Company identities and one to three original passage references per company.

03Read further

Retrieve a passage and its available adjacent context, then continue your own research.

Explore the contract ↗

Connect your AI agent through MCP

Create an API key in Account & API keys. Use Node.js 20.19 or later, replace YOUR_SEV_API_KEY, then restart your MCP client. These examples use the latest approved release. Restart your MCP client to check for updates. For reproducible setups, pin an exact package version.

Codex

Add the entry to ~/.codex/config.toml.

Codex / macOS / Linux
CODEX / CONFIG.TOML
[mcp_servers.sev]
command = "npx"
args = ["-y","--prefer-online","@etsquare/sev-mcp@latest"]
startup_timeout_sec = 30
tool_timeout_sec = 25

[mcp_servers.sev.env]
SEV_BASE_URL = "https://etsquare.ai"
SEV_API_KEY = "YOUR_SEV_API_KEY"
Codex / Windows
CODEX / CONFIG.TOML
[mcp_servers.sev]
command = "cmd"
args = ["/c","npx","-y","--prefer-online","@etsquare/sev-mcp@latest"]
startup_timeout_sec = 30
tool_timeout_sec = 25

[mcp_servers.sev.env]
SEV_BASE_URL = "https://etsquare.ai"
SEV_API_KEY = "YOUR_SEV_API_KEY"

Claude Desktop

Merge the entry into your Claude Desktop configuration, preserving other servers.

Claude Desktop / macOS / Linux
CLAUDE DESKTOP / CONFIG JSON
{
  "mcpServers": {
    "sev": {
      "command": "npx",
      "args": [
        "-y",
        "--prefer-online",
        "@etsquare/sev-mcp@latest"
      ],
      "env": {
        "SEV_BASE_URL": "https://etsquare.ai",
        "SEV_API_KEY": "YOUR_SEV_API_KEY"
      }
    }
  }
}
Claude Desktop / Windows
CLAUDE DESKTOP / CONFIG JSON
{
  "mcpServers": {
    "sev": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "-y",
        "--prefer-online",
        "@etsquare/sev-mcp@latest"
      ],
      "env": {
        "SEV_BASE_URL": "https://etsquare.ai",
        "SEV_API_KEY": "YOUR_SEV_API_KEY"
      }
    }
  }
}

Use the service origin as SEV_BASE_URL; no extra path is needed. The client waits up to 20 seconds per HTTP request without automatic retries. Codex allows 30 seconds for startup and 25 seconds per tool call. These are timeout limits, not response-speed guarantees.

SOURCE READER