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/mcp

A 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

ToolWhat it returnsPlan
search_companiesFind a US company by ticker, name or CIK.Free
latest_filingsRecent filings with title, excerpt and a 1–10 sentiment score. Filter by company, form type, sentiment or date.Free
get_filingThe full analysis of one filing: summary, positives, negatives, risks, and Form 4 transactions or 13F holdings.Free
insider_buysOpen-market purchases by directors, officers and 10% owners from Form 4s, with dollar values. Filter by size or company.Free
company_sentimentHow the tone of a company's filings has moved over time, with the fitted trend.Free
sentiment_shiftsFilings that break sharply from the company's usual tone, such as a going-concern warning from a usually upbeat filer.Paid
sentiment_screenerCompanies whose filing sentiment is rising or falling fastest. Free connections see the top 5.Top 5 free
insider_buying_clustersCompanies 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.