# agentsapi-sec-filings (MCP server)

> SEC EDGAR filings as MCP tools. Pay-per-call in USDC on Base via x402 - no API key, no signup.

## Install
```bash
npx -y agentsapi-sec-filings
```
Or install globally:
```bash
npm install -g agentsapi-sec-filings
```
- npm: https://www.npmjs.com/package/agentsapi-sec-filings
- mirror tarball: https://agentsapi.top/downloads/agentsapi-sec-filings-1.0.0.tgz

## Tools
| Tool | Description | Price |
| --- | --- | --- |
| `sec_filings_today` | Latest 10-K / 10-Q / 8-K filings, newest first (max 40) | $0.01 USDC |
| `sec_filings_8k` | Real-time 8-K material events (M&A, officer changes, earnings, delisting) | $0.005 USDC |
| `sec_filings_service_info` | Free discovery: endpoints, prices, wallet | free |

## Client config
```json
{
  "mcpServers": {
    "sec-filings": {
      "command": "npx",
      "args": ["-y", "agentsapi-sec-filings"],
      "env": { "X402_PRIVATE_KEY": "0x<base-wallet-private-key>" }
    }
  }
}
```
`X402_PRIVATE_KEY` stays local: it only signs the x402 USDC authorization, and is never sent to the API.

## Payment
- Protocol: x402 (HTTP 402 negotiation) - Network: Base mainnet (eip155:8453) - Asset: USDC
- Payable to: `0x381cdbb664608bf7b1dd4f9403a572c1c57332c2`
- Every paid call returns a receipt with `payer`, `amount` and the on-chain `transaction` hash.

## Machine-readable
- \`GET /mcp.json\` - MCP client config template
- \`GET /openapi.json\` - REST API spec
- \`GET /llms.txt\` - agent-readable summary