MCP server

Connect an agent directly.

Marked exposes the same data and services as a Streamable HTTP MCP server for Claude, ChatGPT, Cursor, Codex and compatible clients.

MCPhttps://api.marked.run/mcp/

Authentication

Add X-API-Key: YOUR_API_KEY as a server header. Marked does not require MCP OAuth. Keep the trailing slash in the server URL.

Available tools

search, get_company, get_quote, get_historical_prices, get_financials, get_financial_history, screen_companies, list_screen_metrics, get_shareholding, get_corporate_actions, get_events, list_event_types, get_insider_activity, search_filings, get_filing, get_earnings, query, get_fact_provenance and list_datasets.

Agent contract

Agents should read the query contract and use llms.txt as the complete documentation index. It defines which tool to call, accepted identifiers and stable vocabularies. Dynamic vocabularies must be discovered with list_screen_metrics, list_event_types and list_datasets; do not invent names or infer missing coverage.

Client setup

Claude Code

Run the command shown at right, then verify with claude mcp list.

Cursor

Add the JSON shown at right to ~/.cursor/mcp.json, save and restart Cursor.

Other clients

Create a custom Streamable HTTP server, use the URL above and add the API-key header. Open a new chat or restart clients that load MCP servers only at startup.

Troubleshooting

401Confirm the header name is X-API-Key and replace revoked or mistyped keys.
307Add the trailing slash: use /mcp/, not /mcp.
—If tools do not appear, restart the client or open a new chat.