Back to Browse

Stockportfolio MCP Server

by Avisre
Developer ToolsLow Risk10.0MCP RegistryLocal
Free

Server data from the Official MCP Registry

Filing-grounded US financials and SEC filing research, with source links and no estimates.

About

Filing-grounded US financials and SEC filing research, with source links and no estimates.

Security Report

10.0
Low Risk10.0Low Risk

Valid MCP server (3 strong, 6 medium validity signals). 1 code issue detected. No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry. 1 finding(s) downgraded by scanner intelligence.

8 files analyzed · 2 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

file_system

Check that this permission is expected for this type of plugin.

database

Check that this permission is expected for this type of plugin.

Shell Command Execution

Runs commands on your machine. Be cautious — only use if you trust this plugin.

What You'll Need

Set these up before or after installing:

Required StockPortfolio.pro API key. Create or manage a key at https://www.stockportfolio.pro/api.Required

Environment variable: STOCKPORTFOLIO_API_KEY

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "stockportfolio-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "stockportfolio-mcp@0.3.2"
      ],
      "env": {
        "STOCKPORTFOLIO_API_KEY": "your-stockportfolio-api-key-here"
      }
    }
  }
}

Some servers take additional arguments. See the repository for details.

Documentation

View on GitHub

From the project's GitHub README.

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

Install

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.

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

toolwhat it returns
search_companiesResolve a company name or ticker to a covered US-listed company.
get_company_fundamentalsPeriod-based financial statements with SEC filing sources.
search_filingsSearch filing metadata by company, form, and date range.
get_filingRead selected excerpts from an SEC filing.
ask_filingsResearch a question against company filings and return supporting pulls.
get_recent_filingsReview recent filings across covered companies.
screen_companiesScreen the covered company universe.
get_filing_changesCompare a company's recent filings of the same form.
get_red_flagsSurface warning signs computed from filed statements.
sp_healthFree 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

symptomcause
The API key was rejectedSTOCKPORTFOLIO_API_KEY is missing, revoked, or pasted with quotes.
Out of credits for this monthThe account's allowance is spent. See current options on the API page.
Rate limitedToo many concurrent calls; retry shortly.
npx can't find the packageNode 18+ is required. npx -y stockportfolio-mcp from a terminal shows the same error your client sees.
Client shows no toolsRestart 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-mcp

Links

Informational research only — not investment advice. Fund data is Yahoo-derived and not redistributable.

Reviews

No reviews yet

Be the first to review this server!