StockSavvy for AI agents (MCP)
Give Claude, Cursor or any other MCP client StockSavvy's analysis of every SEC filing as it is published: plain-English summaries, a 1–10 sentiment score, open-market insider buying from Form 4s, and filings that break from a company's usual tone. Your assistant can then answer questions like “which insiders are buying this week?” with sources.
Server URL
https://api.stocksavvy.ai/mcpA remote MCP server (Streamable HTTP). Every tool is read-only.
Try it with no key
The free tools work without signing up. In Claude (web or desktop), open Settings → Connectors, choose Add custom connector, name it StockSavvy and paste the server URL above. Other MCP clients connect the same way.
Keyless use draws on one daily allowance shared by everyone using StockSavvy without a key. If it runs out, the tools say so; a free key gives you your own allowance.
Use your own key
Create a key on your account page. A free key gives you 100 filings a day; the paid plan removes the limit and unlocks the paid tools below. Send the key as a bearer token:
Claude Code
claude mcp add --transport http stocksavvy https://api.stocksavvy.ai/mcp \
--header "Authorization: Bearer sk_live_your_key_here"Cursor
In ~/.cursor/mcp.json (or .cursor/mcp.json in a project):
{
"mcpServers": {
"stocksavvy": {
"url": "https://api.stocksavvy.ai/mcp",
"headers": { "Authorization": "Bearer sk_live_your_key_here" }
}
}
}VS Code
In .vscode/mcp.json. VS Code asks for the key once and stores it as a secret:
{
"inputs": [
{
"type": "promptString",
"id": "stocksavvy-key",
"description": "StockSavvy API key",
"password": true
}
],
"servers": {
"stocksavvy": {
"type": "http",
"url": "https://api.stocksavvy.ai/mcp",
"headers": { "Authorization": "Bearer ${input:stocksavvy-key}" }
}
}
}Custom connectors in Claude.ai don't yet let you add an API key, so keys (and the paid tools) work in clients that can send a header, such as Claude Code, Cursor and VS Code. Any client can also send the key as an X-API-Key header.
Tools
| Tool | What it returns | Plan |
|---|---|---|
| search_companies | Find a US company by ticker, name or CIK. | Free |
| latest_filings | Recent filings with title, excerpt and a 1–10 sentiment score. Filter by company, form type, sentiment or date. | Free |
| get_filing | The full analysis of one filing: summary, positives, negatives, risks, and Form 4 transactions or 13F holdings. | Free |
| insider_buys | Open-market purchases by directors, officers and 10% owners from Form 4s, with dollar values. Filter by size or company. | Free |
| company_sentiment | How the tone of a company's filings has moved over time, with the fitted trend. | Free |
| sentiment_shifts | Filings that break sharply from the company's usual tone, such as a going-concern warning from a usually upbeat filer. | Paid |
| sentiment_screener | Companies whose filing sentiment is rising or falling fastest. Free connections see the top 5. | Top 5 free |
| insider_buying_clusters | Companies where several different insiders bought on the open market in the same window. | Paid |
On a free or keyless connection, a paid tool returns a short note explaining how to unlock it instead of an error, so your assistant can tell you. The screener returns its top 5 with the same note. Filing tools count one per filing returned against the daily allowance; lookups count one each.
Things to ask
- Which insiders bought more than $500K of their own stock this week?
- Summarise everything Tesla filed in the last month. Anything bearish?
- Show me 8-Ks filed today with bearish sentiment.
- Is the tone of Intel’s filings improving or getting worse?
- Which filings this week were a big surprise compared with the company’s usual tone?
Good to know
- Summaries and sentiment scores are machine-generated and can be wrong. Every result links to the StockSavvy page and the original SEC filing, so check the source before relying on it.
- StockSavvy provides information, not investment advice.
- Coverage is US-listed companies' SEC filings. Form 4 insider data is parsed directly from the filing, not by an AI model.
- Prefer plain HTTP? The same data is in the REST API.
Questions or problems: support@stocksavvy.ai. See also our privacy policy and terms.