# AgentDB documentation

> AgentDB is a persistent, typed database for AI agents. Agents define objects and fields, store records and files, link records and run exact typed queries over MCP, REST or the CLI. No SQL.

Version: 1.0.0-rc.13 (released 2026-11-03). MCP: https://app.agentdb.link/mcp. REST: https://app.agentdb.link/v1. Latest docs: https://docs.agentdb.link/latest/

## Guides
- [AgentDB documentation](https://docs.agentdb.link/1.0.0-rc.13/index.md): What you and your AI agents can do with AgentDB, and where to find each guide.
- [Get started](https://docs.agentdb.link/1.0.0-rc.13/getting-started.md): Sign up, get an API key, define contacts and companies, link them and query them in about five minutes.
- [Connect your AI](https://docs.agentdb.link/1.0.0-rc.13/connect-your-ai.md): Connect claude.ai, ChatGPT, Claude Code, Claude Desktop, Cursor and other MCP clients to AgentDB, and manage connected apps.
- [Concepts](https://docs.agentdb.link/1.0.0-rc.13/concepts.md): Workspaces, objects, fields, relationships, records, versions and idempotency keys explained.
- [Query your data](https://docs.agentdb.link/1.0.0-rc.13/querying.md): Filter, sort and page records, compute totals, search text and save queries as views.
- [Query performance](https://docs.agentdb.link/1.0.0-rc.13/query-performance.md): How AgentDB tells you when an index would make a query faster, and how to add one.
- [Files and imports](https://docs.agentdb.link/1.0.0-rc.13/files-and-imports.md): Upload and attach files, share them with expiring links, import CSV, JSON and JSONL files, and export your data.
- [Dashboards and sharing](https://docs.agentdb.link/1.0.0-rc.13/dashboards-and-sharing.md): Build live dashboards, share them with a link or a password, and publish saved views read-only.
- [Automation](https://docs.agentdb.link/1.0.0-rc.13/automation.md): React to changes with signed webhooks, run scheduled jobs and flows, and coordinate agents through channels, the inbox and calendars.
- [Approvals and the AgentHub](https://docs.agentdb.link/1.0.0-rc.13/hub-and-approvals.md): Let a person approve important changes before they happen, and follow approvals, inbox items and notifications in the AgentHub.
- [App packages](https://docs.agentdb.link/1.0.0-rc.13/app-packages.md): Install ready-made apps such as a CRM, to-do list, Kanban board or help desk, and start working right away.
- [Accounts and security](https://docs.agentdb.link/1.0.0-rc.13/accounts-and-security.md): Sign in safely, use two-step sign-in, manage API keys and agents, invite people with roles, and delete a workspace.
- [Troubleshooting](https://docs.agentdb.link/1.0.0-rc.13/troubleshooting.md): What AgentDB error codes and CLI exit codes mean, and what to do about each one.

## Build an app

Build a website, CRM, dashboard or custom application with AgentDB as the persistent data layer, in any language or framework, over the REST API.

Security rule: never put an AgentDB API key (account, workspace or agent key) in browser code, public HTML, a mobile app or a client bundle. Call AgentDB from your own server, which holds the key in an environment variable and checks your own users. For read-only pages without a backend, use a dashboard data link or a custom dashboard instead of a key.

- [Build with AgentDB](https://docs.agentdb.link/1.0.0-rc.13/build/index.md): Build a website, CRM, dashboard or custom application with AgentDB as its database, in your own language and framework.
- [Security for apps](https://docs.agentdb.link/1.0.0-rc.13/build/security.md) (Start): Keep AgentDB keys out of browsers. Three safe patterns for server-side apps, browser apps with a backend, and read-only dashboards.
- [Live data](https://docs.agentdb.link/1.0.0-rc.13/build/live-data.md) (Start): Keep pages and services up to date with polling, the change feed, dashboard long-polling and signed webhooks. Includes a complete page that updates when a record changes.
- [Languages overview](https://docs.agentdb.link/1.0.0-rc.13/build/languages/index.md) (Languages): Use AgentDB from JavaScript, TypeScript, PHP, Python, Go, C#, Java, Ruby, Rust, Swift or Kotlin. Every page runs as a tested example program.
- [JavaScript](https://docs.agentdb.link/1.0.0-rc.13/build/languages/javascript.md) (Languages): Use AgentDB from JavaScript (Node.js) with the built-in fetch of Node.js 22 or newer: records, versions, queries, links, files, errors, retries and idempotency.
- [TypeScript](https://docs.agentdb.link/1.0.0-rc.13/build/languages/typescript.md) (Languages): Use AgentDB from TypeScript with the built-in fetch of Node.js 22, with types: records, versions, queries, links, files, errors, retries and idempotency.
- [PHP](https://docs.agentdb.link/1.0.0-rc.13/build/languages/php.md) (Languages): Use AgentDB from PHP with PHP's built-in curl extension: records, versions, queries, links, files, errors, retries and idempotency.
- [Python](https://docs.agentdb.link/1.0.0-rc.13/build/languages/python.md) (Languages): Use AgentDB from Python with urllib from the standard library: records, versions, queries, links, files, errors, retries and idempotency.
- [Go](https://docs.agentdb.link/1.0.0-rc.13/build/languages/go.md) (Languages): Use AgentDB from Go with net/http and encoding/json from the standard library: records, versions, queries, links, files, errors, retries and idempotency.
- [C#](https://docs.agentdb.link/1.0.0-rc.13/build/languages/csharp.md) (Languages): Use AgentDB from C# (.NET) with HttpClient and System.Text.Json: records, versions, queries, links, files, errors, retries and idempotency.
- [Java](https://docs.agentdb.link/1.0.0-rc.13/build/languages/java.md) (Languages): Use AgentDB from Java with java.net.http.HttpClient: records, versions, queries, links, files, errors, retries and idempotency.
- [Ruby](https://docs.agentdb.link/1.0.0-rc.13/build/languages/ruby.md) (Languages): Use AgentDB from Ruby with Net::HTTP and json from the standard library: records, versions, queries, links, files, errors, retries and idempotency.
- [Rust](https://docs.agentdb.link/1.0.0-rc.13/build/languages/rust.md) (Languages): Use AgentDB from Rust with reqwest (blocking) and serde_json: records, versions, queries, links, files, errors, retries and idempotency.
- [Swift](https://docs.agentdb.link/1.0.0-rc.13/build/languages/swift.md) (Languages): Use AgentDB from Swift with URLSession with async/await: records, versions, queries, links, files, errors, retries and idempotency.
- [Kotlin](https://docs.agentdb.link/1.0.0-rc.13/build/languages/kotlin.md) (Languages): Use AgentDB from Kotlin with java.net.http.HttpClient from the JDK: records, versions, queries, links, files, errors, retries and idempotency.
- [Plain HTML and JavaScript](https://docs.agentdb.link/1.0.0-rc.13/build/frameworks/plain-html-js.md) (Frameworks): A plain HTML page with vanilla JavaScript and a small Node backend that holds the AgentDB key.
- [React](https://docs.agentdb.link/1.0.0-rc.13/build/frameworks/react.md) (Frameworks): A React app that lists and adds AgentDB contacts through its own backend, with loading, empty and error states.
- [Next.js](https://docs.agentdb.link/1.0.0-rc.13/build/frameworks/nextjs.md) (Frameworks): A Next.js App Router app where route handlers hold the AgentDB key and client components fetch them.
- [Vue](https://docs.agentdb.link/1.0.0-rc.13/build/frameworks/vue.md) (Frameworks): A Vue 3 component that lists and adds AgentDB contacts through its own backend.
- [Svelte and SvelteKit](https://docs.agentdb.link/1.0.0-rc.13/build/frameworks/svelte.md) (Frameworks): A SvelteKit app where a server route holds the AgentDB key and the page fetches it.
- [Node.js and Express](https://docs.agentdb.link/1.0.0-rc.13/build/frameworks/node-express.md) (Frameworks): A Node.js backend for AgentDB, with plain node:http (tested) or Express.
- [PHP](https://docs.agentdb.link/1.0.0-rc.13/build/frameworks/php.md) (Frameworks): A server-rendered PHP app on AgentDB with no framework and no Composer packages.
- [Laravel](https://docs.agentdb.link/1.0.0-rc.13/build/frameworks/laravel.md) (Frameworks): Call AgentDB from a Laravel controller with the Http client, and keep the key in config.
- [Python and FastAPI](https://docs.agentdb.link/1.0.0-rc.13/build/frameworks/python-fastapi.md) (Frameworks): A FastAPI service in front of AgentDB with httpx, plus a standard-library version.
- [ASP.NET Core](https://docs.agentdb.link/1.0.0-rc.13/build/frameworks/aspnet.md) (Frameworks): An ASP.NET Core minimal API that calls AgentDB with a named HttpClient and serves a static page.
- [Java and Spring Boot](https://docs.agentdb.link/1.0.0-rc.13/build/frameworks/spring-boot.md) (Frameworks): A Spring Boot REST controller that calls AgentDB with RestClient and keeps the key in configuration.
- [Deployment](https://docs.agentdb.link/1.0.0-rc.13/build/deployment.md) (Deploy): Put an AgentDB app online with nginx, HTTPS, secure headers and server-side keys, on a VPS, Netlify or Vercel.
- [CRM example](https://docs.agentdb.link/1.0.0-rc.13/build/crm-example.md) (Examples): A complete small CRM on AgentDB, in TypeScript and in plain PHP, with contacts, companies, links, search, edits and live updates.

## Reference (one page per feature area; every operation with MCP tool, REST endpoint, CLI command, stability, version added, arguments and an example)
- [Workspaces](https://docs.agentdb.link/1.0.0-rc.13/reference/workspaces.html): Find, create, select, rename, delete and restore workspaces (projects).
- [Schema](https://docs.agentdb.link/1.0.0-rc.13/reference/schema.html): Object types, typed fields, unique keys, indexes; history and undo.
- [Records](https://docs.agentdb.link/1.0.0-rc.13/reference/records.html): Create, read, update, upsert, delete, archive, restore and merge records.
- [Relationships](https://docs.agentdb.link/1.0.0-rc.13/reference/relationships.html): Link and unlink records; list a record's links.
- [Query and search](https://docs.agentdb.link/1.0.0-rc.13/reference/query_search.html): Exact queries (operators per field type), roll-ups, totals by date bucket, full-text search.
- [Files](https://docs.agentdb.link/1.0.0-rc.13/reference/files.html): Upload, attach, download, version, search and share files.
- [Import and export](https://docs.agentdb.link/1.0.0-rc.13/reference/import_export.html): Import CSV/JSON/JSONL files and export workspace data.
- [Views and dashboards](https://docs.agentdb.link/1.0.0-rc.13/reference/views_dashboards.html): Saved views, rendered and published views, live dashboards.
- [Automation](https://docs.agentdb.link/1.0.0-rc.13/reference/automation.html): Webhooks, scheduled jobs (once/cron/RRULE) and trigger flows.
- [Channels and inbox](https://docs.agentdb.link/1.0.0-rc.13/reference/channels_inbox.html): Channels and messages, your inbox, shared conversations (handoff).
- [Approvals and AgentHub](https://docs.agentdb.link/1.0.0-rc.13/reference/approvals_hub.html): Propose sensitive changes; a signed-in person decides in the AgentHub; approval policies.
- [Calendar](https://docs.agentdb.link/1.0.0-rc.13/reference/calendar.html): Calendars, events, availability, free slots, ICS import/export.
- [Knowledge](https://docs.agentdb.link/1.0.0-rc.13/reference/knowledge.html): Knowledge items with citations, proposals, reviews and versions.
- [Integrations](https://docs.agentdb.link/1.0.0-rc.13/reference/integrations.html): Connectors to outside systems: sync, send, inbound events.
- [Package and template operations](https://docs.agentdb.link/1.0.0-rc.13/reference/packages_apps.html): Install ready-made schemas and apps (CRM, todos, kanban, CMS, forms...).
- [Publishing](https://docs.agentdb.link/1.0.0-rc.13/reference/publishing.html): CMS delivery and revisions, public forms, content dispatch.
- [Access and permissions](https://docs.agentdb.link/1.0.0-rc.13/reference/access.html): Named agents and their keys, permissions, who may do what.
- [Administration](https://docs.agentdb.link/1.0.0-rc.13/reference/administration.html): Retention and lifecycle settings, integrity checks.
- [Discovery](https://docs.agentdb.link/1.0.0-rc.13/reference/discovery.html): Find operations (agentdb_capabilities) and run any of them (agentdb_execute).
- [CLI commands](https://docs.agentdb.link/1.0.0-rc.13/reference/cli.html)
- [Field types](https://docs.agentdb.link/1.0.0-rc.13/reference/field-types.html): text, integer, boolean, date, datetime, enum, number, decimal, currency, time, timezone, duration, multi_select, list, json, email, url, phone, address, geo, rich_text, formula, status, user_ref, agent_ref, file, recurrence
- [File types](https://docs.agentdb.link/1.0.0-rc.13/reference/file-types.html)
- [Templates and app packages](https://docs.agentdb.link/1.0.0-rc.13/reference/app-packages.html): agent_crm, agent_kanban, agent_projects, agent_todos, assets, cms, content, crm, forms, inventory, property, recruit, support

## Machine-readable
- [llms-full.txt](https://docs.agentdb.link/1.0.0-rc.13/llms-full.txt): all guides and the full operation reference in one file
- [mcp-tools.json](https://docs.agentdb.link/1.0.0-rc.13/mcp-tools.json): every MCP tool with input schema, stability, added_in, example, REST and CLI equivalents
- [openapi.json](https://docs.agentdb.link/1.0.0-rc.13/openapi.json): REST API (OpenAPI 3.1)
- [capabilities.json](https://docs.agentdb.link/1.0.0-rc.13/capabilities.json): service summary and feature areas
- [skill.md](https://docs.agentdb.link/1.0.0-rc.13/skill.md): official AgentDB skill
- [examples.json](https://docs.agentdb.link/1.0.0-rc.13/examples.json): tested code examples per language (page, files, topics)

## Optional
- [Release notes](https://docs.agentdb.link/1.0.0-rc.13/release-notes.html)