algoum-mcp server

algoum-mcp for AI assistants (MCP)

Let your AI assistant query US financial regulatory data from SEC EDGAR – insider trades (Form 4/5), material events (8-K) and institutional holdings (13F) – through the Model Context Protocol. Ask in plain language, the assistant looks up the data for you.

What you can ask

Ask for what you want to know – the assistant picks the right tools for you.

Insider trades (Form 4 and 5)

Buys and sells reported by officers, directors and 10% owners – for one company or across the whole market – plus the signals derived from them: clusters of buyers and the buy/sell ratio of a company's officers.

• "Which insiders bought NVIDIA shares in the last 7 days?"
• "Where did at least 3 insiders buy within the last 14 days?"
• "What is the officer buy/sell ratio for Tesla over the last 90 days?"
• "Show me the latest insider sales across the market."

Material events (Form 8-K)

The events a company has to disclose – leadership changes, mergers, bankruptcies, cyber incidents, earnings releases and more – as a searchable history or as the latest filings across all companies.

• "Which 8-K filings about cyber incidents came in today?"
• "What material events did Boeing report this year?"
• "Were there any bankruptcy filings in the last 24 hours?"

Institutional holdings (Form 13F)

The quarterly portfolios of institutional investors and the aggregated picture per stock: how many funds hold it, and how many opened, increased or reduced their position.

• "Who holds Apple in 2026-Q1, and what is the institutional sentiment?"
• "Show Bridgewater's portfolio for its latest reported quarter."
• "How many funds increased their Microsoft position last quarter?"
• "Which 13F disclosures came in this week?"

Companies and filings

Ticker and company lookup, the original SEC filing behind every record, and how current each data source is.

• "What is the CIK for Palantir?"
• "Give me the SEC filing behind that trade."
• "How fresh is the data?"

The assistant can also look up the API description itself whenever it needs more detail.

Good to know

money flows.

• Read-only access to published SEC data, taken straight from the official filings.
• Insider trades and material events become available within minutes of being filed.
• Timestamps are in US Eastern Time, exactly as the SEC reports them.
• 13F values are the holdings a fund reported for a quarter, so they describe positions rather than

• The assistant can ask for the current data freshness at any time.

Got a question, or an idea for data you would like to see? Talk to us – we are happy to hear from you.

The API is free to use. If it is useful to you, a donation helps us keep the service running.

Setup

1. Get your API key

Create a key in the dashboard of the algoum portal – the same key you use for the REST API. Create one key per app or machine, so each one stays under your control, and add or revoke keys at any time.

Keep the key in an environment variable, or let your app prompt for it:

export ALGOUM_API_KEY='<your key>'

2. Check the connection

curl -s https://api.algoum.de/v1/mcp \
  -H "Authorization: Bearer $ALGOUM_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

3. Add the server to your assistant

Some assistants can install the server for you – look for algoum in the MCP Registry. With APM two commands set it up for your assistants. Otherwise use the values below.

Shortened. The full README is on GitHub.