# Factbed

> Factbed is a shared fact repository for AI agents: docs that a team and its agents read and write together, made of named facts. Each fact has a value, a source, a date and a full version history. When one agent saves a fact, every other agent can read it by name. Factbed never connects to your company's accounts; agents, services and people write facts to it.

Agents, services, scripts and people all read and write the same record, so a fact written over MCP is the same fact the API, CLI and dashboard return. MCP is the recommended way to connect an agent.

Key concepts:

- A fact is one thing an agent should know: a date, a paragraph, a list, a table or a file.
- Facts are named `doc#fact`, for example `customer.northwind#renewal_date`. The part before `#` is the doc the fact belongs to. In URLs, encode `#` as `%23`.
- Every write saves a new version with its source and date. Earlier versions are kept, with a status such as current, retired or corrected.
- Changes made by agents can wait in a review queue until a person or a reviewing agent confirms or corrects them. The reason stays in the history.
- Give each agent or service its own sign-in or API key, so the history shows which one wrote what.

Connect over MCP:

- Server URL: `https://mcp.factbed.io/mcp` (Streamable HTTP). Auth is OAuth: sign in with a Factbed account; there is no key to paste.
- Tools: `get_fact`, `set_fact`, `search_facts`, `fact_history`.
- Claude Code: `claude mcp add --transport http factbed https://mcp.factbed.io/mcp`, then run `/mcp` and sign in. Add `--scope project` to share it through `.mcp.json`.
- Cursor (`.cursor/mcp.json`): `{"mcpServers": {"factbed": {"url": "https://mcp.factbed.io/mcp"}}}`
- VS Code (`.vscode/mcp.json`): `{"servers": {"factbed": {"type": "http", "url": "https://mcp.factbed.io/mcp"}}}`
- Claude and ChatGPT apps: add a custom connector with the server URL, then sign in.
- Clients that can't do OAuth should use the API with a key instead.

Connect over the API (base URL `https://api.factbed.io/v1`, header `Authorization: Bearer $FACTBED_KEY`; keys come from the dashboard):

```
# Read a fact
curl https://api.factbed.io/v1/facts/customer.northwind%23renewal_date \
  -H "Authorization: Bearer $FACTBED_KEY"
# -> {"value": "2027-03-01", "version": 1, "source": "CRM note", "dated": "2026-11-09", "written_by": "renewals-service"}

# Write a new version with its source
curl -X PUT https://api.factbed.io/v1/facts/customer.northwind%23renewal_date \
  -H "Authorization: Bearer $FACTBED_KEY" \
  -d '{"value": "2027-03-01", "source": "CRM note"}'
# -> {"version": 1, "status": "current"}
```

Connect over the CLI: `npm install -g @factbed/cli`, then `factbed login` (in CI, set `FACTBED_KEY` instead). Commands: `get`, `set`, `search`, `history`, `import` (for example `factbed import prices.csv --doc pricing.list` turns each row into a fact linked to the file).

Pricing: plans are set by how many active facts a workspace holds. People, AI tools, reads and edits are unlimited on every plan. Free is $0 for 100 facts with 30 days of history; Starter is $19/month for 1,000; Growth is $49/month for 5,000; Business is $149/month for 25,000 (annual billing gives 2 months free). Any paid plan can add 1,000 facts for $10/month. Old versions, retired facts and uploaded source documents don't count. Every fact can be exported with its source, date and history as CSV or JSON at any time.

## Pages

- [Home](https://factbed.io/): What Factbed is, the problem it solves, a worked example of teams sharing facts, and how it compares with wikis, agent memory tools (Zep, Mem0, Letta), prompt and config files, and building in-house.
- [Get started](https://factbed.io/get-started): Step-by-step setup for MCP, API, CLI and the dashboard, with MCP instructions for Claude, ChatGPT, Claude Code, Cursor, VS Code and other clients.
- [Pricing](https://factbed.io/pricing): Plans and limits, what counts as a fact, and pricing FAQ.

## Optional

- [Privacy policy](https://factbed.io/privacy): What personal data Factbed collects, who processes it, how long it's kept, and how to make a privacy request.
- [Contact](mailto:hello@factbed.io): Questions, setup help and sales.