# Toolstem SEC EDGAR MCP server

> Provides AI agents with pre-computed SEC EDGAR signals including insider activity, activist risk, and material event digests.

- Repository: https://github.com/toolstem/toolstem-sec-mcp-server
- Page: https://hostedmcp.org/servers/toolstem/toolstem-sec-mcp-server
- Transport: stdio
- Stars: 1
- License: MIT
- Latest version: 0.1.9

## Install

### Claude Code

```sh
claude mcp add toolstem-sec-mcp-server -- npx -y toolstem-sec-mcp-server
```

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

```json
{
  "mcpServers": {
    "toolstem-sec-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "toolstem-sec-mcp-server"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "toolstem-sec-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "toolstem-sec-mcp-server"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"toolstem-sec-mcp-server","type":"stdio","command":"npx","args":["-y","toolstem-sec-mcp-server"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "toolstem-sec-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "toolstem-sec-mcp-server"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add toolstem-sec-mcp-server -- npx -y toolstem-sec-mcp-server
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.toolstem-sec-mcp-server]
command = "npx"
args = ["-y", "toolstem-sec-mcp-server"]
```

### Gemini CLI

```sh
gemini mcp add -s user toolstem-sec-mcp-server npx -- -y toolstem-sec-mcp-server
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "toolstem-sec-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "toolstem-sec-mcp-server"
      ]
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `ALLOW_REMOTE` | no | no |  |
| `SEC_USER_AGENT_CONTACT` | no | no | Contact email embedded in the SEC EDGAR User-Agent (required by SEC fair-access policy). Defaults to admin@toolstem.com. |

## Tools (6)

- `filing_velocity`
- `material_event_count_90d`
- `disclosure_volume_trend`
- `latest_form_types`
- `activist_risk_flag`
- `recent_13d_filings`

## FAQ

### Do I need an SEC API key to use this?

No, the server sources data directly from SEC EDGAR's public submissions API and includes a built-in rate limiter.