AgentStack
Browse Sign in
Browse Why AgentStack Sell Docs
Sign in
MCP verified MIT Self-run

Sec Filings Mcp

mcp-stagproject-sec-filings-mcp · by stagproject

SEC EDGAR filing MCP for agents - search, preview, purchase (x402).

↗ Repository
— No reviews yet
0 installs
21 views
0.0% view→install

Install

$ agentstack add mcp-stagproject-sec-filings-mcp

✓ scanned · ✓ verified, works with Claude Code, Cursor, and more.

Security review

✓ Passed

No issues found. Passed automated security review. · v0.1.0 How review works →

  • ✓ Prompt-injection patterns
  • ✓ Secret / credential exfiltration
  • ✓ Dangerous shell & filesystem operations
  • ✓ Untrusted network calls
  • ✓ Known-malicious package signatures

What it can access

  • ✓ Network access No
  • ✓ Filesystem access No
  • ✓ Shell / process execution No
  • ● Environment & secrets Used
  • ✓ Dynamic code execution No

From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.

View the full security report →

Verified badge

Passed review? Show it. Paste this badge into your README, it links to the public security report.

AgentStack Verified badge Links to your public security report.
[![AgentStack Verified](https://agentstack.voostack.com/badges/verified.svg)](https://agentstack.voostack.com/security/report/mcp-stagproject-sec-filings-mcp)

Reliability & compatibility

✓ Security review passed
0 installs to date
— no reviews yet
● 2mo ago

Declared compatibility

Claude CodeClaude DesktopCursorWindsurf

Compatibility is declared by the source manifest. End-to-end runtime verification is coming, see below.

Preview Execution monitoring

We're building live execution health for every listing: tool-call success rate, median latency, uptime, and last-checked timestamps, measured, not self-reported. It isn't live yet, so we don't show numbers we can't stand behind.

How agent discovery & health will work →
Are you the author of Sec Filings Mcp? Claim this listing to set pricing, connect Stripe payouts, and keep 70% of every sale.
Sign up to claim

About

sec-filings-mcp

[](https://glama.ai/mcp/servers/stagproject/sec-filings-mcp)

SEC EDGAR structured filing MCP for agents: searchfilings, getfilingsample, purchasefiling. Data lives in Supabase views (fi_listings_portfolio, fi_listings_portfolio_compact) populated by the finance-factory pipeline.

| Read first | File | |------------|------| | Try without xpay key | [docs/TRYWITHOUTXPAY.md](docs/TRYWITHOUTXPAY.md) — Glama sandbox or Cloud Run upstream | | Distribution (you vs repo) | [docs/DISTRIBUTION.md](docs/DISTRIBUTION.md) · [docs/HANDOFF.md](docs/HANDOFF.md) | | Build / handoff | [MCPFINANCEBUILD.md](MCPFINANCEBUILD.md) | | Env template | [.env.example](.env.example) → copy to .env | | Glama | [glama.json](glama.json) (maintainers: stagproject); build fix: [GLAMABUILD.md](GLAMABUILD.md) | | A2A / x402 | [docs/A2A.md](docs/A2A.md) — Agent Card + payment mapping | | MCP Registry | io.github.stagproject/sec-filings-mcp — [docs/MCPREGISTRY.md](docs/MCPREGISTRY.md) | | Discovery URLs | [docs/DISCOVERY.md](docs/DISCOVERY.md) |

Template reference: mcp_server.py (patent MCP, unmodified). Runtime: mcp_server_finance.py.

Protocol stack (MCP + A2A + x402)

| Layer | How to use | |-------|------------| | MCP (production) | xpay URL below — tools/call on search_filings, get_filing_sample, purchase_filing | | A2A (discovery) | Agent Card on Cloud Run upstream (xpay blocks /.well-known/*): https://sec-filings-mcp-1065601264332.us-central1.run.app/.well-known/agent-card.json | | x402 (payment) | purchase_filing — 402 + Polygon USDC + tx_hash redelivery |

Native A2A JSON-RPC task API is on the roadmap; today agents invoke via MCP Streamable HTTP. Details: [docs/A2A.md](docs/A2A.md).

Try first (no xpay API key)

| Path | URL / action | |------|----------------| | Glama sandbox | Open server → Try in Browser | | Cloud Run trial | https://sec-filings-mcp-1065601264332.us-central1.run.app/mcp — search_filings + get_filing_sample without ?key= |

Details: [docs/TRYWITHOUTXPAY.md](docs/TRYWITHOUTXPAY.md). xpay proxy always needs a key; per-tool $0 is allowed on xpay (docs) but is not the same as “no signup.”

Connect (production)

| Endpoint | URL | |----------|-----| | xpay (billing + catalog) | https://sec-edgar-filings.mcp.xpay.sh/mcp?key=YOUR_XPAY_KEY | | Cloud Run (upstream) | https://sec-filings-mcp-1065601264332.us-central1.run.app/mcp |

Register / manage on xpay.tools. Slug: sec-edgar-filings. Publisher checklist (finance collection, awesome list): [docs/DISTRIBUTION.md](docs/DISTRIBUTION.md).

Local dev

git clone https://github.com/stagproject/sec-filings-mcp.git
cd sec-filings-mcp
copy .env.example .env
# Edit .env with Supabase + x402 keys
uv sync
# Run once in Supabase SQL Editor: sql/fi_processed_transactions.sql
uv run python mcp_server_finance.py --sse
# MCP: http://127.0.0.1:8081/mcp  (PORT in .env)

Tests:

uv run python test_finance_mcp.py
uv run python test_finance_mcp.py --xpay-only --e2e

Cloud Run

gcloud run deploy sec-filings-mcp `
  --source . `
  --region us-central1 `
  --allow-unauthenticated `
  --port 8080

Set env vars from .env (not committed). Do not deploy .env.cloudrun.yaml to git.

Glama

Listed at glama.ai/mcp/servers/stagproject/sec-filings-mcp — use Try in Browser for a no-key sandbox; production traffic uses xpay or Cloud Run above.

MCP Registry

io.github.stagproject/sec-filings-mcp

Publish / update: [docs/MCPREGISTRY.md](docs/MCPREGISTRY.md). Search: https://registry.modelcontextprotocol.io

License

MIT — see [LICENSE.md](LICENSE.md).

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

Install and usage instructions live in the source repository linked above.

Reviews

No reviews yet, be the first.

Write a review

Versions

  • v0.1.0 Imported from the upstream source.

More in Search