# TanBase Core

> TanBase Core is an open-source TanStack Start application foundation for
> Cloudflare Workers. A working task board runs auth, data, files, realtime,
> background jobs, AI, and an MCP server together in one Worker.

- Production origin: https://core.tanbase.dev/
- License: MIT

The production site runs a personal task board: verified email and password
accounts protected by Cloudflare Turnstile and per-IP rate limits, D1-backed
projects and tasks shown as a board, a sortable list, and weekly stats,
private file attachments in R2, a live board synced across devices through
Durable Objects, due-date reminder emails through Cron Triggers and Queues, AI
task breakdown through Workflows and Workers AI, and an MCP server. A public
blog, written in Markdown in the repository, explains how it is built.

## Docs

- [Homepage](https://core.tanbase.dev/): What TanBase Core is, the map of Cloudflare primitives, the cost model, and how to deploy it. Request it with `Accept: text/markdown` for Markdown.
- [Blog](https://core.tanbase.dev/blog): Posts about building TanBase Core, also as an [RSS feed](https://core.tanbase.dev/blog/rss.xml)
- [README](https://github.com/tanfust/tanbase-core/blob/main/README.md): Overview, quick start, and current scope
- [Architecture](https://github.com/tanfust/tanbase-core/blob/main/docs/OVERVIEW.md): Principles, feature-to-primitive map, performance budgets, and cost model
- [Guided installation](https://github.com/tanfust/tanbase-core/blob/main/docs/INSTALLING.md): Deploy your own copy with `pnpm run setup`
- [Feature roadmap](https://github.com/tanfust/tanbase-core/blob/main/docs/FEATURES.md): Done and planned features with acceptance criteria
- [Current status](https://github.com/tanfust/tanbase-core/blob/main/docs/STATUS.md): What production runs today, with verification evidence
- [Deployment runbook](https://github.com/tanfust/tanbase-core/blob/main/docs/DEPLOYMENT.md): How production deploys from `main`
- [Agent discovery](https://github.com/tanfust/tanbase-core/blob/main/docs/AGENT_DISCOVERY.md): The public discovery documents and what each one describes

## For agents

- [MCP server](https://core.tanbase.dev/mcp): Streamable HTTP endpoint that lists, creates, and completes the signed-in person's tasks. Clients authorize with OAuth 2.1 through TanBase Core's own authorization server at https://core.tanbase.dev/api/auth, using Dynamic Client Registration. The person signs in and approves the client; there are no API keys.
- [Protected resource metadata](https://core.tanbase.dev/.well-known/oauth-protected-resource/mcp): OAuth metadata for the MCP server
- [MCP server card](https://core.tanbase.dev/mcp/server-card): The MCP server's name, transport, and tools
- [Task skill](https://core.tanbase.dev/.well-known/agent-skills/tanbase-core-tasks/SKILL.md): How to manage tasks through the MCP server, listed in the [agent skills index](https://core.tanbase.dev/.well-known/agent-skills/index.json)
- [API catalog](https://core.tanbase.dev/.well-known/api-catalog): RFC 9727 catalog listing the MCP server
- [AI Catalog](https://core.tanbase.dev/.well-known/ai-catalog.json): Agentic resources: the server card, the skill, and the API catalog
- In the browser, pages register the same task tools through WebMCP.

## Capabilities not currently offered

TanBase Core does not offer a public REST API, API keys, agent registration
without a person signing in, an A2A agent, or payments. The sitemap, robots
policy, and discovery documents describe only implemented resources.

## Optional

- [Source repository](https://github.com/tanfust/tanbase-core): The full source, MIT licensed
- [Sitemap](https://core.tanbase.dev/sitemap.xml): The pages search engines may index: the homepage, the blog, and its posts

Production deployment is not verified until the canonical URL passes the
repository smoke checks and that evidence is recorded in the status snapshot.