# finicast / FiniDB

> FiniDB is a modeling database for AI agents: named tables, pivot tables (a grid of line items × periods with formulas placed by condition) and conditional formulas that recalculate incrementally in milliseconds. finicast.com hosts it; `npx finidb` runs it locally with no server or account.

## Docs

- [Agent landing page](https://finicast.com/agent): what FiniDB is, how to connect, concepts, the ten most useful API calls, delivery checklist (under 3,000 tokens). Fetch with `Accept: text/markdown` or `?format=md`.
- [Agent guide](https://finicast.com/guide): concepts, the five commands with JSON, formulas, runnable recipes, verification, pitfalls, API cheat sheet.
- [REST API (OpenAPI 3.1)](https://finicast.com/docs/api/openapi.json): every route of the FiniDB daemon; the hosted base is `https://finicast.com/db/<project>`.
- [Function catalog](https://finicast.com/docs/functions): every formula function with examples.
- [MCP discovery](https://finicast.com/.well-known/mcp.json): where the MCP server is and how to authenticate.

## Connect

- Local, zero setup: `npx finidb guide` then `npx finidb apply model.json --data ./model`.
- Local MCP: `npx finidb mcp --data ./model`.
- Hosted MCP: `claude mcp add finicast -- npx finidb mcp --url https://finicast.com/db/<project> --token <project-token>`
- Hosted REST: `https://finicast.com/db/<project>/…` with `Authorization: Bearer <project-token>` (a project token is issued at https://finicast.com/app).
- Status: https://finicast.com/status