Documentation

Build with Platos

The open source agent runtime. 51 reference docs covering the platform, engine, governance, observability, and developer experience surfaces.

Install Platos in your AI assistant

Platos ships an MCP gateway. Wire Claude Code, Cursor, or Claude Desktop to your runtime in one command, then call agents and tools directly from your editor.

claude mcp add platos https://mcp.platos.dev/mcp

Platform

20 docs

Agents

Durable, versioned agents with their own prompt, tools, models, memory, and budgets.

Agent versions, canary, rollback

Version every change to an agent and roll back instantly without losing conversation history.

Agent clusters

Group agents that share memory, threads, and user identity so a chat agent and a background agent feel like one.

Skills

Reusable agent behaviors with manifests, required env vars, and Claude-skills compatibility.

Official skills catalog

First-party skills shipped with Platos including code execution, csv-ops, and platos-rag.

Tools and tool routing

How Platos routes a tool call from the agent to a connected entity, a skill, or a meta-tool.

Connected entities

External backends that connect to Platos over WebSocket and expose their tools to agents without exposing their data.

Memory

Long-term, scoped, ratable memory that powers personalization without leaking across tenants.

Memory graph

Knowledge-graph view over memory, with entity nodes and relations extracted from conversations.

Conversations and threads

How a conversation is stored, encrypted, branched, forked, and threaded.

Chat and Postman mode

The agent chat playground and the Postman-style request console for inspecting tool pipelines.

Agent context

The four-tier context resolver that injects user, session, agent, and project values into tool calls and prompts.

Prompts

How Platos assembles a prompt, when it caches, and how prompt blocks compose.

Models

Pick a model per agent, compare two models head to head, and see which providers must be linked.

Providers and BYOK

Bring your own provider keys (OpenAI, Anthropic, etc.) and link them per environment with a checklist.

Evals

Define eval criteria once, run them against golden sets, and see ratings roll up per agent.

A/B evals

Compare two agent versions head to head on the same set of inputs.

Artifacts

Platos-generated structured outputs (markdown, code, html-sandboxed, json, csv, svg, image) that render consistently in any client.

Attachments and files

Upload files, images, and PDFs into a conversation and let the agent reference them as multimodal inputs.

Platos tasks (BGOs)

Long-running background operations spawned from agents via the spawn_bgo meta-tool.

Engine

6 docs

Governance

5 docs

Observability

5 docs

Developer experience

15 docs

FAQ

Common questions about Platos — what it is, how it compares, where to deploy, how to use it.

play.platos.dev — public playground (NOT production)

What play.platos.dev is, what it isn't, and where to deploy your real agents.

Scope tuple and multi-tenancy

The (organizationId, projectId, environmentId) tuple that gates every scoped row in Platos.

Auth modes and session tokens

Three auth modes (direct headers, session-token JWT, service secret on WS) plus user-token passthrough.

SDKs (TypeScript and Python)

First-party client libraries for Platos, including the consumer @platosdev/client and the entity-side platools SDKs.

React widget

Drop-in React FAB chat widget — three identity flows (anonymous form, OTP-verified, backend-authenticated), every per-turn agent option exposed, fully themable.

MCP gateway

Universal MCP endpoint that federates entity tools, trigger meta-tools, Platos skills, and the control plane.

MCP tokens and PATs

Personal Access Tokens (pmt_*) and OAuth 2.1 DCR flows for MCP clients.

OpenAPI and REST

The HTTP REST surface auto-generated from controllers, with a downloadable OpenAPI spec.

Webhooks

Outbound HTTP webhooks for conversation lifecycle events, run state transitions, and safety hits.

Public agents and embed

Share an agent publicly via a guest-token route, or drop in a web-component embed.

Self-hosting

Run Platos on your own infra with a single docker compose up. Postgres, Redis, ClickHouse, MinIO, agent, webapp.

Environments

Per-project dev/staging/prod environments with their own scoped env vars, providers, and queues.

Streaming and WebSocket events

Real-time stream of token deltas, tool calls, artifacts, and run updates over WebSocket.

Terms, privacy, security policy

Where to find Platos's legal documents, security disclosure process, and what each covers.

Talk to Platos

Powered by the Platos runtime

Powered by Platos →