---
name: seraphix-feed
description: Query Seraphix Feed, dated public records about tracked U.S. companies from free government sources (SEC, EPA, EIA, FERC, DOJ, CFPB, FTC, USAspending, each while LIVE), over MCP or REST with an API key, and cite each item by its primary document.
---

# Seraphix Feed

Dated public records about the companies Seraphix tracks, from free government sources. Every item is served as stored, with its primary document link on a government host and its own timestamps. A record that names an individual is served as filed and flagged pertains_to_individual. No text is generated by the server.

## Access
No key: single records, pages, feeds and bulk files are free; cross-company search and the live stream cost $0.002 a call via x402. Free key: 100 calls a month, no card.
- Get a free key on https://seraphixsystems.com/account, or subscribe at https://seraphixsystems.com/feed for a paid tier. A key is shown once; only a salted hash is stored.
- Send it on every request: `Authorization: Bearer sxk_live_...`
- A per-network rate limit applies without a key. Every keyed request counts toward its tier.

## MCP
Endpoint: `POST https://seraphixsystems.com/mcp` (Streamable HTTP, JSON-RPC 2.0) with the Authorization header. The public `tools/list` includes all 20 registered tools without a key; access follows the policy above:
- `search_records`
- `get_record`
- `list_companies`
- `get_company`
- `get_filings_wire`
- `get_coverage`
- `answer`
- `graph_neighborhood`
- `who_is_behind`
- `create_board`
- `pilot02_follow_the_money`
- `tx_site_status`
- `search_organizations`
- `get_organization_record`
- `screen_organizations`
- `get_whats_moving`
- `list_feed_sources`
- `get_feed_events`
- `what_changed_since`
- `explain_record`

## REST
- `GET /api/v1/feed/sources`: sources with status, agencies LIVE or NOT_LIVE, tracked companies, rules, your tier.
- `GET /api/v1/feed/events?company=&source=&since=&until=&limit=&cursor=`: items newest first.
- `GET /api/v1/feed/companies/{cik_or_slug}/events` and `GET /api/v1/feed/sources/{source}/events`: the same, scoped.
- `GET /api/v1/feed/changes?company=&since=`: what changed for one company since a date.
- `GET /api/v1/feed/records/{id}`: one item with its primary link and stored quote.
- `GET /api/v1/feed/usage`: requests this billing period, limit, reset time.

Dates are ISO 8601. Agency records compare by `publication_date` (whole UTC day); filings-wire items by SEC `accepted` time. Page with `limit` (1-500) and `next_cursor`.

## Rules
1. Call `list_feed_sources` (or `/api/v1/feed/sources`) first. Only LIVE sources serve records. A DEGRADED source serves nothing: its silence is not zero, so never conclude "no records" from it.
2. Use the stored fields as they are. `timestamps` holds the stored point-in-time fields (filed, accepted, publication_date, event_date, fetched_at); nothing is estimated.
3. `quote` is the stored quote or null. Do not present anything else as a quote. Read the primary document before relying on an item.
4. A filings-wire item is SEC index metadata (machine-extracted). An 8-K is a company-stated disclosure, not a finding.
5. A record that names an individual carries pertains_to_individual: true and is a public record as filed. Do not use the feed as a consumer report or to screen a person for credit, employment, insurance, housing or tenancy (FCRA).

## Citation
`<source label> · <company legal name> · <time field> <time value> · <primary_url> · Seraphix Feed <id> v<version>` (the `citation` field of every item gives this line).

## Tiers and errors
- Personal: 25,000 requests per billing month, 1 year of history, 60 a minute. Pro: no monthly cap, full history, 120 a minute. Commercial: Pro with 300 a minute, priority support and invoice billing. Enterprise: by quote, written agreement. Every record is CC BY 4.0 for everyone, commercial use included, with attribution. Paid tiers pay for the service: keys, limits, history and support. Enterprise agreements are arranged by email.
- Headers: `X-RateLimit-Limit`, `X-RateLimit-Remaining` (Personal), `X-RateLimit-Reset` (unix seconds), `X-Usage-Count`, `X-Feed-Tier`.
- 401 `API_KEY_REQUIRED` / `INVALID_API_KEY` / `API_KEY_REVOKED`; 403 `SUBSCRIPTION_INACTIVE`; 429 `QUOTA_EXCEEDED` or `RATE_LIMITED` (fair use per minute) with `Retry-After` (seconds); 404 `NOT_FOUND`; 400 `INVALID_ARGUMENT`. Errors are JSON: `{"error":{"code","message"}}`.

Docs: https://seraphixsystems.com/developers#feed · OpenAPI: https://seraphixsystems.com/openapi.json

## The toll: paying per request (x402)
- Free, no key: one record at a time (`/r/{record_id}`, `.json`, `.md`, `/api/v1/records/{id}`, `/api/v1/feed/records/{id}`, `/api/v1/feed/sources`, MCP `get_record`, `explain_record`, `list_feed_sources`). Cite the record.
- Tolled without a key: search across companies $0.002; live stream $0.002 per request, in USDC on `eip155:8453`.
- HTTP: the route answers 402 with `PAYMENT-REQUIRED` (base64 JSON, x402 version 2). Pay exactly `accepts[0]` and repeat the request with `PAYMENT-SIGNATURE` (base64 PaymentPayload). Success carries `PAYMENT-RESPONSE` with the transaction hash. A payment is used once; a failed request is not settled.
- MCP: an isError tool result with `structuredContent` = PaymentRequired; repeat the call with `params._meta["x402/payment"]`.
- A free key (100 requests a month, 30 days of history) is on https://seraphixsystems.com/account; with a key there is no 402 until its quota is used. Details: https://seraphixsystems.com/toll

## as_of (point-in-time reads)
- GET /api/v1/feed/events, /api/v1/feed/companies/{company}/events and /api/v1/feed/sources/{source}/events take as_of=YYYY-MM-DD (end of that UTC day): only items Seraphix had observed by then (agency records by fetched_at, filings-wire items by SEC acceptance time). The same view is on /quality?as_of= and /company/{slug}/timeline?as_of=.
- Not on the MCP tools yet: use the REST routes for as_of.
