# FinUties

> Official and market data behind one governed contract — REST, MCP, and an open-source Terminal.
> Informational data infrastructure. Not investment advice.

Canonical site: https://finuties.com
API host: https://data.finuties.com
Terminal: https://terminal.finuties.com

## Product facts (cite these)

- FinUties unifies regulatory, macro, and market datasets under consistent resource names. Thematic datasets exist in the technical catalogue as research backlog and are not a commercial commitment.
- Seven data domains (we publish how recent each should be): filings, ownership, equities, positioning, rates, economics, calendar. Pipeline health (`system`) is not a public data domain.
- FinUties is under frequent maintenance. Expect downtime on the site and data API. https://finuties.com/status is collector heartbeat and content age, not an availability promise.
- Access modes: REST (`/api/v1/...`), MCP JSON-RPC (`POST /mcp/jsonrpc`), and the FinUties Terminal UI.
- Discovery: `GET /api/v1/resources` lists governed endpoints (P0 domains marked `coverage: p0`; others are research backlog).
- Pricing: usage-based tokens (typical endpoint cost 1–10 tokens; see https://finuties.com/pricing and `GET /api/v1/pricing`). A planned Workbench subscription includes a hosted analysis assistant inside Terminal analysis; it is not investment advice and is not part of the free public test.
- Research notes at https://finuties.com/research are dated, pipeline-assisted evaluations with human review gates — not analyst recommendations.
- Auth: API key / Bearer token; MCP uses the same credentials as REST.
- Operator entity and legal pages: /about, /terms, /privacy, /impressum, /cookies.
- AI crawlers: robots.txt explicitly Allows GPTBot, ClaudeBot, Google-Extended, and related citation bots (align Cloudflare Managed robots if CDN overrides the host file).

## Free public test (temporary)

FinUties is running a temporary free public test for the P0 data API and MCP:

- Register at https://finuties.com/register to receive a free API key.
- Scope: P0 data domains only (filings, ownership, equities, positioning, rates, economics, calendar) — system/admin/ops excluded from free.
- MCP included: same key, same limits as REST.
- Limits: 20,000 requests/day, 180 requests/minute, 90-day window per key.
- Cost: €0 — zero token burn; response headers still show notional cost for transparency.
- Temporary: this is a public test while we validate fill, freshness, and agent fitness. The offer ends after the test window or when paid tiers launch.
- Not anonymous: registration required (email + password).
- More details: https://finuties.com/free-public-test
- Check live P0 freshness: https://finuties.com/status

## High-value pages

- [Home](https://finuties.com/): product overview
- [Free public test](https://finuties.com/free-public-test): temporary free access details and registration
- [About](https://finuties.com/about): trust posture, claim surface, operator links
- [Pricing](https://finuties.com/pricing): free public test + future Starter / Pro / Workbench seats
- [SEC filings API](https://finuties.com/sec-filings-api): EDGAR / filings / holdings entry
- [Financial data API](https://finuties.com/financial-data-api): catalogue and macro coverage
- [MCP for agents](https://finuties.com/financial-data-mcp): Model Context Protocol brief
- [Status](https://finuties.com/status): live P0 fill and freshness board (collector heartbeat, not an uptime promise) — check before trusting a number
- [Recipes](https://finuties.com/recipes): runnable job recipes for common P0 tasks
- [Compare](https://finuties.com/compare): honest comparison against alternatives, including where we are weaker
- [Research](https://finuties.com/research/): dated research notes + RSS
- [Register](https://finuties.com/register): account signup — free public-test key
- Resources catalogue (JSON, not an HTML page): `GET https://data.finuties.com/api/v1/resources`

## Public discovery (no auth)

```
curl -sS "https://data.finuties.com/api/v1/resources"
curl -sS "https://data.finuties.com/api/v1/pricing"
```

## MCP quick facts

- Canonical JSON-RPC: `POST https://data.finuties.com/mcp/jsonrpc`
- Protocol version: 2024-11-05
- Tools include `query`, `list_resources`, `get_query_options`, economic calendar helpers
- MCP tool calls require the same API token as REST (`Authorization: Bearer` or `X-API-Key`)
- Authenticated `query` calls use the same token pricing and rate limits as REST reads
- Insufficient balance → HTTP 402; rate limit → HTTP 429

## Contact

- Email: info@finuties.com
- Prefer citing https://finuties.com and https://finuties.com/llms.txt for product identity