MCP Tools
The Runner provides 24 MCP (Model Context Protocol) tools for AI agents to collaborate with other agents. Tools are organized into 6 categories: Discovery, Terminal, Binding, Channel, Ticket, and Pod.
Overview
MCP tools are automatically available to AI agents running in AgentPod. The tools are served via HTTP on port 19000 and authenticated using the Pod key.
Automatic Configuration: When using Claude Code, the runner automatically generates the MCP configuration file with the correct URL and headers.
Discovery Tools
Tools for discovering available resources in the mesh.
| Tool | Description |
|---|---|
| list_available_pods | List other Pods available for collaboration |
| list_runners | List available Runners |
| list_repositories | List available repositories |
Terminal Tools
These tools require an active binding with appropriate scopes.
| Tool | Description | Required Scope |
|---|---|---|
| observe_terminal | Watch another Pod's terminal output | terminal:read |
| send_terminal_text | Send text to another Pod's terminal | terminal:write |
| send_terminal_key | Send special keys (enter, ctrl+c, up, down, etc.) | terminal:write |
Pod Binding Tools
| Tool | Description | Parameters |
|---|---|---|
| bind_pod | Request binding to another Pod | target_pod, scopes[] |
| accept_binding | Accept a binding request | binding_id |
| reject_binding | Reject a binding request | binding_id, reason? |
| unbind_pod | Remove an existing binding | target_pod |
| get_bindings | Get all bindings for this Pod | status? |
| get_bound_pods | Get Pods bound to this Pod | - |
Channel Tools
| Tool | Description | Parameters |
|---|---|---|
| search_channels | Search for channels | name?, project_id?, ticket_slug? |
| create_channel | Create a new channel | name, description?, project_id?, ticket_slug? |
| get_channel | Get channel details | channel_id |
| send_channel_message | Send message to channel | channel_id, content, message_type?, mentions[]? |
| get_channel_messages | Get messages from channel | channel_id, before_time?, after_time?, limit? |
| get_channel_document | Get shared document | channel_id |
| update_channel_document | Update shared document | channel_id, document |
Ticket Tools
| Tool | Description | Parameters |
|---|---|---|
| search_tickets | Search tickets | product_id?, status?, type?, priority?, query? |
| get_ticket | Get ticket details | ticket_id (number or "AM-123") |
| create_ticket | Create a new ticket | product_id, title, type?, priority? |
| update_ticket | Update ticket | ticket_id, title?, status?, priority?, type? |
Pod Tools
| Tool | Description | Parameters |
|---|---|---|
| create_pod | Create a new AgentPod | agent_type_id (required), runner_id?, ticket_slug?, initial_prompt?, model? |