# TAI42

> tai is an open-source runtime for MCP tools, agents, and workflows — the server that hosts tools, agents, extensions, connectors, hooks, and storage for the TAI42 ecosystem.

## Docs

- [Access control](https://docs.tai42.ai/concepts/access-control.md): The jq-policy request-auth gate.
- [Accounts](https://docs.tai42.ai/concepts/accounts.md): Human accounts, sessions, and the login flows that sign a person in.
- [Agents](https://docs.tai42.ai/concepts/agents.md): LLM-driven capabilities and how they are authored.
- [Backends](https://docs.tai42.ai/concepts/backends.md): Where tools run: background, scheduled, distributed.
- [Config and secrets](https://docs.tai42.ai/concepts/config-and-secrets.md): Swappable config and secret providers.
- [Connectors](https://docs.tai42.ai/concepts/connectors.md): OAuth connections to outside apps.
- [Deep agents](https://docs.tai42.ai/concepts/deep-agents.md): Multi-step agents and the ready-made set.
- [Hooks](https://docs.tai42.ai/concepts/hooks.md): Logic that runs at points in the request lifecycle.
- [Concepts](https://docs.tai42.ai/concepts/index.md): The core subsystems of the platform, one page per pillar.
- [Interactions](https://docs.tai42.ai/concepts/interactions.md): Human-in-the-loop, in-client and external.
- [The layering](https://docs.tai42.ai/concepts/layering.md): How contract, kit, skeleton, and Studio stack.
- [Live operations](https://docs.tai42.ai/concepts/live-operations.md): Operate a server without a restart.
- [The manifest](https://docs.tai42.ai/concepts/manifest.md): The declarative file a server loads at startup.
- [The marketplace](https://docs.tai42.ai/concepts/marketplace.md): The plugin index: listings, items, versions, and advisories.
- [The MCP-citizen surface](https://docs.tai42.ai/concepts/mcp-citizen-surface.md): MCP-native features and the FastMCP escape hatch.
- [Owned keys](https://docs.tai42.ai/concepts/owned-keys.md): Delegation as a capped sub-identity: attenuation, the capability projection, and per-identity isolation.
- [Presets](https://docs.tai42.ai/concepts/presets.md): Versioned, named wraps of a tool.
- [Private tool sets](https://docs.tai42.ai/concepts/private-tool-sets.md): Scoped sub-MCP servers.
- [Storage and resources](https://docs.tai42.ai/concepts/storage-and-resources.md): The ResourceManager and stored content.
- [Tools and extensions](https://docs.tai42.ai/concepts/tools-and-extensions.md): Atoms of work and the clip-on powers over them.
- [Transports](https://docs.tai42.ai/concepts/transports.md): HTTP, SSE, STDIO, and the UDS path.
- [Triggers and webhook verifiers](https://docs.tai42.ai/concepts/triggers-and-webhooks.md): Firing tools from outside events.
- [The versioning spine](https://docs.tai42.ai/concepts/versioning-spine.md): One versioned-store primitive, many kinds.
- [The worker bus](https://docs.tai42.ai/concepts/worker-bus.md): How a config change reaches every worker.
- [Contributing](https://docs.tai42.ai/contributing.md): Where each repository's contributing guide lives.
- [Installation](https://docs.tai42.ai/getting-started/installation.md): Install the tai runtime and its packages.
- [Mental model](https://docs.tai42.ai/getting-started/mental-model.md): How the runtime fits together in one page.
- [Quickstart](https://docs.tai42.ai/getting-started/quickstart.md): Boot a server and call a tool over MCP.
- [Set up access control](https://docs.tai42.ai/guides/access-control.md): Turn on the gate and write a policy.
- [Apply an extension](https://docs.tai42.ai/guides/apply-an-extension.md): Clip an extension onto a tool.
- [Author an agent](https://docs.tai42.ai/guides/author-an-agent.md): Author an agent against the contract.
- [Author an accounts provider](https://docs.tai42.ai/guides/authors/accounts-provider.md): Own human accounts, login flows, and the sessions they mint.
- [Author an agent plugin](https://docs.tai42.ai/guides/authors/agent-plugin.md): Implement the Agent contract.
- [Author a backend](https://docs.tai42.ai/guides/authors/backend.md): Build a worker backend engine.
- [Author a channel](https://docs.tai42.ai/guides/authors/channel.md): Build a channel plugin.
- [Author code plugins](https://docs.tai42.ai/guides/authors/code-plugins.md): The four manifest-wired code plugin types.
- [Author a config provider](https://docs.tai42.ai/guides/authors/config-provider.md): Implement the config-manager contract.
- [Author a connector](https://docs.tai42.ai/guides/authors/connector.md): Build an OAuth connector plugin.
- [Author an extension](https://docs.tai42.ai/guides/authors/extension.md): Build a wrapper or transformer.
- [Author an identity provider](https://docs.tai42.ai/guides/authors/identity-provider.md): Resolve an inbound token into an authenticated identity.
- [Plugin authors](https://docs.tai42.ai/guides/authors/index.md): An author path for every plugin type.
- [Author a monitoring backend](https://docs.tai42.ai/guides/authors/monitoring-backend.md): Implement the monitoring surface.
- [The plugin descriptor](https://docs.tai42.ai/guides/authors/plugin-descriptor.md): Describe a plugin with tai-plugin.yml.
- [Author a storage provider](https://docs.tai42.ai/guides/authors/storage-provider.md): Implement the storage contract.
- [Author a tool](https://docs.tai42.ai/guides/authors/tool.md): Build a tool plugin.
- [Author a webhook verifier](https://docs.tai42.ai/guides/authors/webhook-verifier.md): Build a webhook verifier plugin.
- [Back up and restore](https://docs.tai42.ai/guides/backup-and-restore.md): Back up and restore stored state.
- [Bring an MCP server](https://docs.tai42.ai/guides/bring-an-mcp-server.md): Mount an external MCP server's tools.
- [Build a tool](https://docs.tai42.ai/guides/build-a-tool.md): Register a Python function as a tool.
- [Connect an OAuth provider](https://docs.tai42.ai/guides/connect-an-oauth-provider.md): Wire an OAuth connector end to end.
- [Create and version a preset](https://docs.tai42.ai/guides/create-and-version-a-preset.md): Save and evolve a configured tool.
- [Deploy](https://docs.tai42.ai/guides/deploy.md): Run a server for real.
- [Embed in your own ASGI process](https://docs.tai42.ai/guides/embed.md): Serve the runtime from a factory you own — a plain uvicorn run, or mounted inside an existing app.
- [Fire a tool from a webhook](https://docs.tai42.ai/guides/fire-a-tool-from-a-webhook.md): Bind a tool to an inbound webhook.
- [Guides](https://docs.tai42.ai/guides/index.md): Task-shaped how-to guides.
- [Manage a fleet](https://docs.tai42.ai/guides/manage-a-fleet.md): Read the live worker census, inspect the backend, and drive fleet-wide operations.
- [Manage stored content and templates](https://docs.tai42.ai/guides/manage-stored-content.md): Store, list, and load resources.
- [Observe](https://docs.tai42.ai/guides/observe.md): Collect metrics and traces.
- [Use owned keys](https://docs.tai42.ai/guides/owned-keys.md): Mint a capped key, inspect what it can do, and share it by QR claim link.
- [Expose a private tool set](https://docs.tai42.ai/guides/private-tool-set.md): Publish a scoped sub-MCP server.
- [Schedule a tool](https://docs.tai42.ai/guides/schedule-a-tool.md): Run a tool on a schedule.
- [The standard toolbox](https://docs.tai42.ai/guides/standard-toolbox.md): Enable the shipped default tools and extensions.
- [Use interactions](https://docs.tai42.ai/guides/use-interactions.md): Ask a human mid-run with ask_user, and drive external approvals with ask_external.
- [Use the ready-made agents](https://docs.tai42.ai/guides/use-the-ready-made-agents.md): Enable and run the seven shipped agents.
- [TAI42 — the OS for AI tools](https://docs.tai42.ai/index.md): An open-source runtime for MCP tools, agents, and workflows — the server that runs them.
- [Claude Desktop](https://docs.tai42.ai/integrations/claude-desktop.md): Connect Claude Desktop to a running server.
- [Cursor](https://docs.tai42.ai/integrations/cursor.md): Connect Cursor to a running server.
- [Integrations](https://docs.tai42.ai/integrations/index.md): Connect MCP clients to a running server.
- [MCP clients](https://docs.tai42.ai/integrations/mcp-clients.md): Connect any MCP client.
- [Advisories](https://docs.tai42.ai/marketplace/advisories.md): How a server hears about bad versions, and the poll setting.
- [Browse and search](https://docs.tai42.ai/marketplace/browse.md): Find plugins by the items they carry — CLI, Studio, or the web.
- [Marketplace](https://docs.tai42.ai/marketplace/index.md): Browse the plugin index and install into a running server.
- [Install a plugin](https://docs.tai42.ai/marketplace/install.md): Install, update, and uninstall marketplace plugins server-side.
- [HTTP API](https://docs.tai42.ai/reference/api/index.md): The operator HTTP surface served under /api/*, with API-key auth and a data/error envelope.
- [Ecosystem catalog](https://docs.tai42.ai/reference/catalog/index.md): Every shipped tool, extension, agent, connector, and provider in the tai ecosystem.
- [tai agents](https://docs.tai42.ai/reference/cli/agents.md): List and run agents.
- [tai auth](https://docs.tai42.ai/reference/cli/auth.md): Identity and capability introspection.
- [tai backend](https://docs.tai42.ai/reference/cli/backend.md): Run a tai execution-backend runtime (worker / beat / dashboard).
- [tai backup](https://docs.tai42.ai/reference/cli/backup.md): Export and import server state.
- [tai catalog](https://docs.tai42.ai/reference/cli/catalog.md): Print the packaged ecosystem catalog.
- [tai channels](https://docs.tai42.ai/reference/cli/channels.md): Inspect the registered delivery channels.
- [tai completion](https://docs.tai42.ai/reference/cli/completion.md): Install shell completion for the tai CLI.
- [tai config](https://docs.tai42.ai/reference/cli/config.md): Read and update server configuration.
- [tai connectors](https://docs.tai42.ai/reference/cli/connectors.md): Manage connector providers and connections.
- [tai db](https://docs.tai42.ai/reference/cli/db.md): Apply and inspect the database schema.
- [tai doctor](https://docs.tai42.ai/reference/cli/doctor.md): Run read-only health diagnostics against the environment.
- [tai extensions](https://docs.tai42.ai/reference/cli/extensions.md): Browse the global tool-extension catalog.
- [tai fleet](https://docs.tai42.ai/reference/cli/fleet.md): Inspect the execution backend and drive fleet ops.
- [tai hooks](https://docs.tai42.ai/reference/cli/hooks.md): Register and inspect webhook hooks.
- [CLI](https://docs.tai42.ai/reference/cli/index.md): The tai command-line tool: one entrypoint, global flags, and config resolution.
- [tai interactions](https://docs.tai42.ai/reference/cli/interactions.md): Stream and answer pending interactions.
- [tai keys](https://docs.tai42.ai/reference/cli/keys.md): Manage API keys and their access-control conditions.
- [tai manifest](https://docs.tai42.ai/reference/cli/manifest.md): Inspect and validate the server manifest.
- [tai mcp](https://docs.tai42.ai/reference/cli/mcp.md): Inspect and configure mounted MCP servers.
- [tai metrics](https://docs.tai42.ai/reference/cli/metrics.md): Serve the Prometheus metrics endpoint.
- [tai notifications](https://docs.tai42.ai/reference/cli/notifications.md): Read and send internal notifications.
- [tai obs](https://docs.tai42.ai/reference/cli/obs.md): Query observability metrics.
- [tai openapi](https://docs.tai42.ai/reference/cli/openapi.md): Emit the OpenAPI 3.1 specification for the `/api/*` surface.
- [tai plugins](https://docs.tai42.ai/reference/cli/plugins.md): Browse and install marketplace plugins.
- [tai presets](https://docs.tai42.ai/reference/cli/presets.md): Manage preset tools and their versions.
- [tai resources](https://docs.tai42.ai/reference/cli/resources.md): Load stored resources by id.
- [tai schedules](https://docs.tai42.ai/reference/cli/schedules.md): Manage scheduled jobs.
- [tai scopes](https://docs.tai42.ai/reference/cli/scopes.md): Manage access-control scopes.
- [tai serve](https://docs.tai42.ai/reference/cli/serve.md): Run the tai MCP server (FastMCP + Starlette), serving the Studio SPA too.
- [tai storage](https://docs.tai42.ai/reference/cli/storage.md): Inspect and manage the storage provider's resources.
- [tai sub-mcp](https://docs.tai42.ai/reference/cli/sub-mcp.md): Register and inspect sub-MCP apps.
- [tai system](https://docs.tai42.ai/reference/cli/system.md): Inspect the server's own runtime surface.
- [tai templates](https://docs.tai42.ai/reference/cli/templates.md): Manage prompt and resource templates.
- [tai tools](https://docs.tai42.ai/reference/cli/tools.md): Inspect and run registered tools.
- [tai traces](https://docs.tai42.ai/reference/cli/traces.md): List and inspect run traces.
- [tai version](https://docs.tai42.ai/reference/cli/version.md): Show the tai42-skeleton version and the versions of its key dependencies.
- [Python SDK](https://docs.tai42.ai/reference/python-sdk/index.md): The generated Python SDK reference.
- [Accounts (tai42_contract.accounts)](https://docs.tai42.ai/reference/python-sdk/tai-contract-accounts.md): The AccountsProvider contract, its registry, and the login-method metadata models.
- [Agents (tai42_contract.agent)](https://docs.tai42.ai/reference/python-sdk/tai-contract-agent.md): The Agent base class plugin authors subclass.
- [App facade (tai42_contract.app)](https://docs.tai42.ai/reference/python-sdk/tai-contract-app.md): The assembled TaiApp facade and its per-feature namespaces.
- [Backends (tai42_contract.backend)](https://docs.tai42.ai/reference/python-sdk/tai-contract-backend.md): The Backend protocol a compute backend implements.
- [Channels (tai42_contract.channels)](https://docs.tai42.ai/reference/python-sdk/tai-contract-channels.md): The Channel protocol a delivery channel plugin implements.
- [Connectors (tai42_contract.connectors)](https://docs.tai42.ai/reference/python-sdk/tai-contract-connectors.md): The ProviderDescriptor a connector plugin declares.
- [Extensions (tai42_contract.extensions)](https://docs.tai42.ai/reference/python-sdk/tai-contract-extensions.md): The ExtensionKind taxonomy and extension base surface.
- [Manifest (tai42_contract.manifest)](https://docs.tai42.ai/reference/python-sdk/tai-contract-manifest.md): The manifest model a server loads at startup.
- [Monitoring (tai42_contract.monitoring)](https://docs.tai42.ai/reference/python-sdk/tai-contract-monitoring.md): The MonitoringReader and MonitoringWriter protocols.
- [Plugins (tai42_contract.plugins)](https://docs.tai42.ai/reference/python-sdk/tai-contract-plugins.md): The PluginSpec model behind tai-plugin.yml.
- [Presets (tai42_contract.presets)](https://docs.tai42.ai/reference/python-sdk/tai-contract-presets.md): The PresetStore protocol and preset document models.
- [Storage (tai42_contract.storage)](https://docs.tai42.ai/reference/python-sdk/tai-contract-storage.md): The Storage protocol a storage provider implements.
- [Tools (tai42_contract.tools)](https://docs.tai42.ai/reference/python-sdk/tai-contract-tools.md): Tool registration types and the app tools namespace.
- [Versioning (tai42_contract.versioning)](https://docs.tai42.ai/reference/python-sdk/tai-contract-versioning.md): The VersionedStore primitive behind presets and policies.
- [Pooled clients (tai42_kit.clients)](https://docs.tai42.ai/reference/python-sdk/tai-kit-clients.md): Pooled Postgres/Redis clients and connection settings.
- [LLM factories (tai42_kit.llm)](https://docs.tai42.ai/reference/python-sdk/tai-kit-llm.md): LLM, embedding, checkpoint, and store factories.
- [Logging (tai42_kit.logging)](https://docs.tai42.ai/reference/python-sdk/tai-kit-logging.md): Structured logging settings and setup.
- [Network guard (tai42_kit.net)](https://docs.tai42.ai/reference/python-sdk/tai-kit-net.md): The URL guard and safe fetch helpers.
- [Settings (tai42_kit.settings)](https://docs.tai42.ai/reference/python-sdk/tai-kit-settings.md): The base settings class and the settings registry.
- [Transports (tai42_kit.transport)](https://docs.tai42.ai/reference/python-sdk/tai-kit-transport.md): UDS transports and the MCP transport factory.
- [Skeleton app (tai42_skeleton.app)](https://docs.tai42.ai/reference/python-sdk/tai-skeleton-app.md): The concrete TaiMCP app, including the raw fastmcp escape hatch.
- [ASGI factory (tai42_skeleton.asgi)](https://docs.tai42.ai/reference/python-sdk/tai-skeleton-asgi.md): The public create_app factory for embedding the server in a user-owned ASGI process.
- [Settings reference](https://docs.tai42.ai/reference/settings.md): Every environment variable the tai server reads, grouped by settings group.
- [Components](https://docs.tai42.ai/reference/studio-sdk/components.md): The design-system components — inputs, layout, tables, pickers, and disclosure primitives.
- [Hooks](https://docs.tai42.ai/reference/studio-sdk/hooks.md): The React hooks and providers every feature builds on — API access, theme, auth, and the interactions stream.
- [Host & testing](https://docs.tai42.ai/reference/studio-sdk/host-testing.md): The host-only registry API (loadPlugin / getContributions) and the test-only reset.
- [Studio SDK](https://docs.tai42.ai/reference/studio-sdk/index.md): The generated @tai42/studio-sdk reference — the plugin contract, hooks, and design system.
- [MCP widgets](https://docs.tai42.ai/reference/studio-sdk/mcp-widgets.md): The MCP-context widgets — elicitation forms and structured-output rendering.
- [Navigation](https://docs.tai42.ai/reference/studio-sdk/navigation.md): The shell⇄feature route-token contract — the navigation provider, links, and resolution hooks.
- [Plugin API](https://docs.tai42.ai/reference/studio-sdk/plugin-api.md): The plugin contract a Studio plugin implements — the context, contribution types, and the compatibility gate.
- [Schema forms](https://docs.tai42.ai/reference/studio-sdk/schema-forms.md): The schema-driven form renderer and the JSON Schema helpers it is built on.
- [Utilities](https://docs.tai42.ai/reference/studio-sdk/utilities.md): Shared helpers and re-exported types the SDK exposes.
- [Admin console & live ops](https://docs.tai42.ai/studio/admin-console.md): Watch a server's health, read its metrics and settings, and drive live operations from the browser.
- [API keys](https://docs.tai42.ai/studio/api-keys.md): Sign in with a deployment API key and provision further keys from the Studio.
- [Deploying the Studio](https://docs.tai42.ai/studio/deploy.md): Serve the built Studio app from the skeleton, with the import map and OAuth-bridge notes.
- [Studio](https://docs.tai42.ai/studio/index.md): The desktop workbench for a running server — browse and exercise every surface from the browser.
- [Sign in](https://docs.tai42.ai/studio/login.md): Sign in to the Studio with a login method, an invite, or an API key.
- [Author a Studio plugin](https://docs.tai42.ai/studio/plugins.md): Extend the Studio shell with pages, panels, tabs, and nav entries.
- [Running tools](https://docs.tai42.ai/studio/running-tools.md): Synchronous runs versus detached background runs, and the trade-off between them.
- [The screens](https://docs.tai42.ai/studio/screens.md): A tour of every surface in the Studio sidebar.

## OpenAPI Specs

- [openapi](https://docs.tai42.ai/openapi.json)