Skip to main content
Glama
agentsapi-sec-filings

agentsapi-sec-filings


AIGC: Label: "1" ContentProducer: 001191440300708461136T1XGW3 ProduceID: 920b5c8629efc4aabcea22970c4daaa6_b54ca5ffad0411f18039525400461939 ReservedCode1: KqzVXnEGI8Gcpo7Vcvy8qtyqbGOzj4N8S/k0gymQ95w8Re1g/gGRDviJoo284tPWUuqGz3JDVGV4678a9M6vBJeUmToR/X6mpVxfkk3rYnufIPZ+lyQiXbvc/zoHICST+dM6AtCI2MJI1GuuWSFPIPvixhu/+EP9XzA4GOxJJA//0QwVLRCXKzYf218= ContentPropagator: 001191440300708461136T1XGW3 PropagateID: 920b5c8629efc4aabcea22970c4daaa6_b54ca5ffad0411f18039525400461939 ReservedCode2: KqzVXnEGI8Gcpo7Vcvy8qtyqbGOzj4N8S/k0gymQ95w8Re1g/gGRDviJoo284tPWUuqGz3JDVGV4678a9M6vBJeUmToR/X6mpVxfkk3rYnufIPZ+lyQiXbvc/zoHICST+dM6AtCI2MJI1GuuWSFPIPvixhu/+EP9XzA4GOxJJA//0QwVLRCXKzYf218=

agentsapi-sec-filings

MCP server exposing SEC EDGAR filings as agent-callable tools — pay-per-call in USDC on Base via x402. No API key, no subscription: every call settles a micropayment on-chain and returns data immediately.

Related MCP server: edgar-mcp

Tools

Tool

Description

Price

sec_filings_today

Latest 10-K / 10-Q / 8-K filings across US markets, newest first (max 40)

$0.01 USDC / call

sec_filings_8k

Real-time 8-K material events stream (M&A, executive changes, earnings, delisting, bankruptcy)

$0.005 USDC / call

sec_filings_service_info

Free discovery: endpoints, prices, payment network, wallet

free

Every paid response carries a receipt block (paid, payer, amount, transaction) so the caller can audit settlement.

Requirements

  • Node.js >= 18

  • An EVM wallet holding USDC on Base (mainnet, eip155:8453) plus a small amount of ETH for gas on the first transfer

  • The private key is used locally to sign the x402 payment payload; it is never sent to the server

Install

npx -y agentsapi-sec-filings

Or install globally:

npm install -g agentsapi-sec-filings

Configuration

Env var

Required

Default

Purpose

X402_PRIVATE_KEY

yes

—

EVM private key (0x...) used to sign payments

X402_RPC_URL

no

https://mainnet.base.org

Base RPC endpoint

AGENTSAPI_BASE

no

https://agentsapi.top

API base URL

Claude Desktop / Claude Code

{
  "mcpServers": {
    "sec-filings": {
      "command": "npx",
      "args": ["-y", "agentsapi-sec-filings"],
      "env": {
        "X402_PRIVATE_KEY": "0x<your-base-wallet-key>"
      }
    }
  }
}

Cursor / Windsurf / any stdio MCP client

{
  "mcpServers": {
    "sec-filings": {
      "command": "npx",
      "args": ["-y", "agentsapi-sec-filings"],
      "env": { "X402_PRIVATE_KEY": "0x<your-base-wallet-key>" }
    }
  }
}

Example agent usage

"Any 8-K filings in the last few hours that look like M&A activity?"

The agent calls sec_filings_8k, the client answers the HTTP 402 challenge with a signed USDC transfer, and the filing list comes back with EDGAR links — $0.005 settled, no signup.

Payment flow

  1. Tool call issues GET https://agentsapi.top/api/filings/8k

  2. Server replies 402 Payment Required with x402 terms (USDC, Base, amount, payTo)

  3. Client signs an EIP-3009 USDC authorization and retries with X-PAYMENT

  4. Facilitator settles on-chain; server returns data + X-PAYMENT-RESPONSE receipt

Pricing rationale

  • Data is refreshed every 10 minutes; each response contains up to 40 filings.

  • No rate limits, no API keys — cost scales exactly with usage, which keeps agents free to call as needed.

License

MIT (内容由AI生成,仅供参考)

Available Tools

3 tools
sec_filings_8kSEC 8-K material events (real-time)A
Read-only

Real-time stream of SEC EDGAR 8-K current reports — material corporate events such as M&A, officer changes, earnings releases, delisting and bankruptcy. Sorted by filing time descending, max 40 per call. Paid per call: $0.005 USDC on Base, settled automatically over x402.

Inputs: no named parameters.

sec_filings_service_infoSEC filings API service info (free)A
Read-only

Free discovery endpoint: describes the available SEC EDGAR data endpoints, their prices, payment network and wallet address. Use this first to check pricing before calling a paid tool.

Inputs: no named parameters.

sec_filings_todayLatest SEC filings (10-K / 10-Q / 8-K)A
Read-only

Latest SEC EDGAR filings across 10-K, 10-Q and 8-K form types, sorted by filing time descending (max 40 per call, refreshed every 10 minutes). Each item: form type, company name + CIK, filing time (UTC), EDGAR archive URL. Paid per call: $0.01 USDC on Base, settled automatically over x402.

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 3 tools

    Disambiguation4/5

    The three tools are mostly distinct: sec_filings_today covers all form types, sec_filings_8k focuses specifically on 8-K filings, and sec_filings_service_info is a free metadata/pricing endpoint. There is slight overlap between sec_filings_today and sec_filings_8k since 8-Ks are included in the broader tool, but the descriptions clarify the different scopes.

    Naming Consistency4/5

    All tool names follow a consistent sec_filings_ prefix with a descriptive suffix (today, 8k, service_info). The pattern is predictable, though 'service_info' is slightly less verb-oriented than the other two names.

    Tool Count3/5

    Three tools is on the low end for a server, but the narrow purpose of SEC filings access makes the count reasonable. The inclusion of a free service info tool is useful, though the server could benefit from additional endpoints like a specific 10-K/10-Q filter or a company-specific lookup.

    Completeness3/5

    The server covers today's filings and a dedicated 8-K stream, which addresses the core use case of monitoring recent SEC EDGAR filings. However, it lacks obvious complementary operations such as searching by company/CIK, retrieving a specific filing's details, or filtering by date range, leaving notable gaps for a filings-focused API.

    Maintenance

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      SEC EDGAR filing MCP for equity research agents: search 10-K/10-Q/8-K with CompanyFacts metrics, preview a free sample, and purchase full structured JSON via x402 USDC on Polygon. Public endpoint on xpay.tools.
      3
      2
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Provides structured US SEC/EDGAR filing data, including filings index, XBRL-derived earnings, and Form 4 insider transactions, as clean JSON via MCP. Supports x402 payments (USDC on Base) and Stripe subscription for access.
      MIT