Read and analyze SEC EDGAR filings in Python. 10-K, 8-K, XBRL financials, Form 3/4/5, 13F, ADV — clean API, well-typed, MIT-licensed.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add edgartools --env EDGAR_IDENTITY='<EDGAR_IDENTITY>' -- uvx edgartools~/.codex/config.toml
[mcp_servers.edgartools]
command = "uvx"
args = ["edgartools"]
env = { EDGAR_IDENTITY = "<EDGAR_IDENTITY>" }
# codex mcp add edgartools --env EDGAR_IDENTITY='<EDGAR_IDENTITY>' -- uvx edgartools~/.cursor/mcp.json
{
"mcpServers": {
"edgartools": {
"command": "uvx",
"args": [
"edgartools"
],
"env": {
"EDGAR_IDENTITY": "<EDGAR_IDENTITY>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"edgartools": {
"type": "stdio",
"command": "uvx",
"args": [
"edgartools"
],
"env": {
"EDGAR_IDENTITY": "<EDGAR_IDENTITY>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"edgartools": {
"command": "uvx",
"args": [
"edgartools"
],
"env": {
"EDGAR_IDENTITY": "<EDGAR_IDENTITY>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"edgartools": {
"command": "uvx",
"args": [
"edgartools"
],
"env": {
"EDGAR_IDENTITY": "<EDGAR_IDENTITY>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"edgartools": {
"command": "uvx",
"args": [
"edgartools"
],
"env": {
"EDGAR_IDENTITY": "<EDGAR_IDENTITY>"
}
}
}
}Environment variables
EDGAR_IDENTITY
Replace the placeholders with your own credentials and keep them out of version control.