MCP tools

The MCP server provides read tools for agents, sources, conversations, and organizations, plus write tools for controlled creation, restoration, updates, tests, deletion, and organization switching. Read access is intentionally narrower than write access. Treat tools that delete, update, or test an agent as consequential even when the client can invoke them in one step: a test creates an mcp_test conversation and spends model credits.

MCP sources support url and text. URL indexing is asynchronous: creating a source returns its indexing state and next action, then get_source can be polled until it is ready. Agent and source soft deletes can be restored only during the 30-day window. Optional include fields expose additional agent, source, or conversation detail; request them only when a workflow needs them.

The server resolves the active organization from a manually pinned MCP organization, then the active dashboard organization, then the oldest membership. switch_organization persists the selection. Tool responses echo organization identity; use it to detect an unexpected context before applying a mutation.