# Gapup SEC Filing Decoder

> Gapup SEC Filing Decoder is a paid API for AI agents from mcp.gapup.io, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-14).

Analyzes SEC filings for a company by ticker or CIK, extracting insights on financial health, red flags, M&A clues, or governance across 10-K, 10-Q, 8-K, DEF-14A, and S-1 documents.

## Facts

- Endpoint: POST https://mcp.gapup.io/api/v1/call/sec_filing_decoder
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gapup-sec-filing-decoder-b39a70e4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ovvwfMFsLH-LJ6k0pNwZY

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability gapup-sec-filing-decoder-b39a70e4 -d '<json body>'
```

Example prompt: Can you decode Tesla's SEC 10-K and 10-Q filings from the last 12 months and flag any red flags or M&A clues? Use ticker TSLA.

## When to prefer this

Use this endpoint when you need AI-interpreted analysis of SEC filings rather than raw document retrieval — especially when you want structured signals like red flags, M&A clues, or governance issues extracted automatically without reading full filings manually.

## Known failure modes

- Invalid or unknown ticker symbol returns an error or empty result
- CIK not found in SEC EDGAR database
- No filings of the requested type found within the lookback window
- Async job_id returned but polling endpoint not called, causing result loss
- Lookback period exceeds 60 months, rejected by schema validation
- Filing type enum value not recognized

## How this service works

REST gateway for the Gapup MCP catalogue — 271 AI tools accessible via standard HTTP. Authentication via Authorization: Bearer <api_key>. Native MCP transport available at /mcp.

## Output

A structured JSON object containing decoded insights from the requested SEC filings, organized by the chosen focus area (financial-health, red-flags, m&a-clues, governance, or all), drawn from the specified filing types over the lookback period.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "cik": {
   "type": "string",
   "maxLength": 10,
   "minLength": 1
  },
  "async": {
   "type": "boolean",
   "description": "If true, returns a job_id immediately (<200ms) instead of waiting for the result. Poll the result with job_result(job_id). Use for slow tools to avoid client timeouts."
  },
  "focus": {
   "enum": [
    "financial-health",
    "red-flags",
    "m&a-clues",
    "governance",
    "all"
   ],
   "type": "string",
   "default": "all"
  },
  "ticker": {
   "type": "string",
   "maxLength": 5,
   "minLength": 1
  },
  "filing_types": {
   "type": "array",
   "items": {
    "enum": [
     "10-K",
     "10-Q",
     "8-K",
     "DEF-14A",
     "S-1",
     "all"
    ],
    "type": "string"
   },
   "default": [
    "10-K"
   ],
   "maxItems": 6,
   "minItems": 1
  },
  "lookback_months": {
   "type": "integer",
   "default": 12,
   "maximum": 60,
   "minimum": 1
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "tool": "sec_filing_decoder",
  "result": {},
  "source": "rest-api"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gapup-sec-filing-decoder-b39a70e4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mcp.gapup.io](https://www.zero.xyz/host/mcp.gapup.io/llms.txt)