stockportfolio-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
stockportfolio-mcp
Filing-grounded US financial data and SEC filing research for your agent. Figures retain their fiscal periods and source links; missing values are not estimated. Coverage is US-listed companies that report in USD.
# Create or manage an API key → https://www.stockportfolio.pro/apiInstall
The hosted MCP server supports OAuth 2.1/DCR. Clients that support remote Streamable HTTP can
connect directly to https://www.stockportfolio.pro/mcp and sign in. The local npm bridge is for
clients that need stdio and requires a StockPortfolio.pro API key.
Related MCP server: edgar-mcp
Install the Cursor plugin
The Cursor Marketplace plugin connects to the hosted MCP server. After the plugin is listed, install
it from Cursor's Customize page and complete the sign-in prompt. If your client does not offer a
remote-MCP sign-in for https://www.stockportfolio.pro/mcp, send your API key as a header instead.
To configure a remote server manually, add one of these entries to ~/.cursor/mcp.json or the
project's .cursor/mcp.json:
{
"mcpServers": {
"stockportfolio": {
"url": "https://www.stockportfolio.pro/mcp"
}
}
}{
"mcpServers": {
"stockportfolio": {
"url": "https://www.stockportfolio.pro/mcp",
"headers": { "Authorization": "Bearer your-api-key" }
}
}
}Continuing use needs a StockPortfolio.pro account; the plugin itself is free and MIT.
Install the local stdio bridge
Add this to your MCP client's config and restart it:
Claude Desktop — ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)
or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"stockportfolio": {
"command": "npx",
"args": ["-y", "stockportfolio-mcp"],
"env": { "STOCKPORTFOLIO_API_KEY": "your-key-here" }
}
}
}The stdio bridge requires STOCKPORTFOLIO_API_KEY (or MCP_API_KEY) in its environment. It does
not provide anonymous keyless access. Create a key from the API page linked above.
Requires Node 18 or newer; npx fetches the package on first run. Nothing else to install —
this package bundles everything it needs.
Tools
tool | what it returns |
| Resolve a company name or ticker to a covered US-listed company. |
| Period-based financial statements with SEC filing sources. |
| Search filing metadata by company, form, and date range. |
| Read selected excerpts from an SEC filing. |
| Research a question against company filings and return supporting pulls. |
| Review recent filings across covered companies. |
| Screen the covered company universe. |
| Compare a company's recent filings of the same form. |
| Surface warning signs computed from filed statements. |
| Free liveness probe. |
Research tools consume the allowance attached to the signed-in account. Current plans, credit costs, and trial availability are listed on the API page; they can change, so this README does not repeat price or allowance figures.
Every successful financial or filing response includes the relevant company, fiscal period, and SEC
filing source URL. Filing excerpts retain their filing URL; supplemental data is identified by
source. Missing values are returned as missing rather than estimated. The live /mcp endpoint
advertises the current tool schemas to clients during connection, so the list above is the current
source of truth for available tools.
What's in this package
A stdio MCP server that proxies to the hosted endpoint at
https://www.stockportfolio.pro/mcp. It reads JSON-RPC on stdin, forwards each request with your
key as a bearer header, and relays the reply to stdout. No filing data, no model code and no
server logic ship in the tarball — the only thing it holds is the key you give it, and it sends
that key nowhere except that endpoint.
Because the endpoint is stateless, one bridge per client is fine and there is no session to resume — a dropped connection is rebuilt on the next call.
Troubleshooting
symptom | cause |
|
|
| The account's allowance is spent. See current options on the API page. |
| Too many concurrent calls; retry shortly. |
| Node 18+ is required. |
Client shows no tools | Restart the client after editing the config — the MCP config is read at startup. |
The bridge prints its errors to stderr, which most MCP clients surface in their log pane. To see them directly, run it yourself:
STOCKPORTFOLIO_API_KEY=your-key npx -y stockportfolio-mcpLinks
Pricing and key management: https://stockportfolio.pro/api?utm_source=npm&utm_medium=integration&utm_campaign=stockportfolio-mcp
REST API (same data, HTTP): https://stockportfolio.pro/api/v1
Source and coverage: https://www.stockportfolio.pro/
Informational research only — not investment advice. Fund data is Yahoo-derived and not redistributable.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
SEC-filed company financials with filing citations, plus market data, for AI agents
Research US-listed companies and funds with the StockPortfolio.pro MCP server. Tools cover SEC filing-grounded financials, filing timelines, company comparisons, watchlist screens, fund profiles, and cited filing questions. Filed figures include their fiscal period and EDGAR source URL; missing filing data is returned as null. Public tools work without authentication; optional API-key or OAuth access is supported. US-listed, USD-reporting companies only. Keyless access includes 3 free AI questions per rolling 30-day window. To get more now, choose the Dev plan ($19.99/month, 200 credits) at https://www.stockportfolio.pro/register?plan=dev, then follow https://www.stockportfolio.pro/docs/api-mcp to connect with OAuth or an API key. Or wait for the free allowance to renew.
Agent-native SEC data, 20 tools: statements assembled, any line item, filings synthesized. No key.
Research U.S. public companies from their SEC filings: financials, XBRL facts and filing text.
Related MCP Servers
- AlicenseAqualityBmaintenanceProvides access to SEC EDGAR financial data, enabling AI agents to fetch company filings, financial metrics, and narrative sections. It supports natural-language metric searching and extracts structured data from 10-K, 10-Q, and 8-K reports.6125 PyPIMIT
- AlicenseAqualityBmaintenanceEnables AI agents to query US public company financial data from SEC filings, with tools for resolving tickers, listing filings, retrieving financial concepts, comparing companies, extracting filing sections, and full-text search. It surfaces data ambiguities like tag variations, restatements, and fiscal-year misalignment rather than hiding them.6MIT
- AlicenseBqualityCmaintenanceEnables asking questions about US public companies' SEC filings, returning exact XBRL figures with their tags and accession numbers alongside narrative answers cited to specific filing sections with sec.gov links. Its tools let clients search companies, pull metrics and multi-year financials, compare firms, and index or check ingestion status of filings, with retrieval scoped per company.7MIT
- FlicenseNot gradedqualityCmaintenanceGives AI assistants structured, read-only access to public market data — quotes, 84-field fundamentals snapshots, screeners with filter catalogues, headlines with price reactions, SEC filings, insider and institutional ownership, short interest, earnings, dilution risk, options chains with greeks, market indices and rendered chart PNGs — through 17 tools that need no API key or account. Every payload carries its own source URL and typed error envelopes, so answers stay traceable back to the page they came from.-