Skip to main content

​
MCP Clients

SEC Edgar MCP works with any MCP-compatible client. Here’s a comprehensive list of available clients and how to configure them.

​
Desktop Applications

​
Claude Desktop

Claude Desktop

Platform: Windows, macOS, Linux
Type: Official Anthropic desktop app
Best for: Individual users, AI-powered researchClaude Desktop is the most popular MCP client, providing direct integration with Claude AI for interactive financial analysis.Configuration file location:
  • macOS/Linux: ~/.config/claude-desktop/config.json
  • Windows: %APPDATA%\Claude\claude-desktop\config.json
{
  "mcpServers": {
    "sec-edgar-mcp": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "SEC_EDGAR_USER_AGENT=Your Name (email@example.com)",
        "stefanoamorelli/sec-edgar-mcp:latest"
      ]
    }
  }
}

​
Continue

Continue

Platform: VS Code, JetBrains IDEs
Type: IDE extension
Best for: Developers, code-integrated analysisContinue brings AI assistance directly to your IDE with MCP support for contextual coding help.Configuration: Add to .continue/config.json:
{
  "models": [...],
  "mcpServers": {
    "sec-edgar-mcp": {
      "command": "uvx",
      "args": [
        "--from", "git+https://github.com/stefanoamorelli/sec-edgar-mcp.git",
        "sec-edgar-mcp"
      ],
      "env": {
        "SEC_EDGAR_USER_AGENT": "Your Name (email@example.com)"
      }
    }
  }
}

​
Cline (formerly Claude Dev)

Cline

Platform: VS Code
Type: VS Code extension
Best for: Autonomous coding tasks, file managementCline is an autonomous AI assistant that can create, edit, and execute code with human oversight.Configuration: Through VS Code settings or settings.json:
{
  "cline.mcpServers": {
    "sec-edgar-mcp": {
      "command": "python",
      "args": ["-m", "sec_edgar_mcp.server"],
      "env": {
        "SEC_EDGAR_USER_AGENT": "Your Name (email@example.com)"
      }
    }
  }
}

​
Command Line Tools

​
MCP CLI

MCP CLI

Platform: All platforms
Type: Command-line interface
Best for: Testing, debugging, automationOfficial command-line tool for testing and debugging MCP servers.
# Install MCP CLI
npm install -g @modelcontextprotocol/cli

# Connect to SEC Edgar MCP
mcp connect "docker run -i --rm -e SEC_EDGAR_USER_AGENT='Test User (test@example.com)' stefanoamorelli/sec-edgar-mcp:latest"

# List available tools
mcp tools list

# Call a tool
mcp call lookup_company_cik '{"company_name": "Apple"}'

​
MCP Client SDK

MCP Client SDK

Platform: Python, TypeScript/JavaScript
Type: SDK for building custom clients
Best for: Custom integrations, automationBuild your own MCP client using official SDKs.Python example:
from mcp import Client
import asyncio

async def main():
    async with Client() as client:
        # Connect to SEC Edgar MCP
        await client.connect(
            command="python",
            args=["-m", "sec_edgar_mcp.server"],
            env={"SEC_EDGAR_USER_AGENT": "Bot (bot@example.com)"}
        )
        
        # List available tools
        tools = await client.list_tools()
        
        # Call a tool
        result = await client.call_tool(
            "lookup_company_cik",
            {"company_name": "Tesla"}
        )
        print(result)

asyncio.run(main())

​
Web Applications

​
LibreChat

LibreChat

Platform: Web (self-hosted)
Type: Multi-model chat interface
Best for: Teams, self-hosted deploymentsOpen-source AI chat platform with MCP support for multiple models.Configuration: Add to librechat.yaml:
mcp:
  servers:
    sec-edgar:
      command: docker
      args:
        - run
        - -i
        - --rm
        - -e
        - "SEC_EDGAR_USER_AGENT=LibreChat (admin@example.com)"
        - stefanoamorelli/sec-edgar-mcp:latest

​
Open WebUI

Open WebUI

Platform: Web (self-hosted)
Type: Web interface for LLMs
Best for: Self-hosted AI assistantsFeature-rich web UI for various LLMs with extensibility through tools and functions.Note: MCP support is in development. Check their documentation for updates.

​
Mobile & Emerging Clients

​
Mobile MCP Clients

Mobile MCP clients are emerging. Check the MCP ecosystem for the latest mobile client developments.

​
Custom Integrations

Any application can become an MCP client by implementing the MCP protocol specification. The protocol uses JSON-RPC 2.0 over stdio, SSE, or WebSocket transports.

​
Configuration Best Practices

Always set the SEC_EDGAR_USER_AGENT with your actual name and email:
SEC_EDGAR_USER_AGENT="John Doe (john.doe@company.com)"
The SEC requires proper identification for API access.
Docker (Recommended):
  • Isolated environment
  • No Python version conflicts
  • Consistent across platforms
Direct Installation (pip/uvx):
  • Lower resource usage
  • Faster startup time
  • Easier debugging
After configuration, test your connection:
  1. Restart your MCP client
  2. Check if SEC Edgar tools are discovered
  3. Try a simple query like company lookup
  4. Verify tool responses include SEC URLs
Common issues and solutions:
  • Tools not appearing: Check JSON syntax and restart client
  • Connection errors: Verify Docker is running or Python path is correct
  • SEC errors: Ensure User-Agent includes valid email
  • Rate limiting: Add delays between requests

​
Finding More Clients

The MCP ecosystem is rapidly growing. Find the latest clients and tools:

​
Next Steps

Configuration Guide

Advanced configuration options

Docker Setup

Detailed Docker installation guide

Troubleshooting

Common issues and solutions

Tools Overview

Explore available SEC Edgar tools
⌘I