MCP Tools
The Runner provides 26 MCP (Model Context Protocol) tools for AI agents to collaborate with other agents. Tools are organized into 7 categories: Discovery, Terminal, Binding, Channel, Ticket, Pod, and Loop.
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 |
Pod Tools
Tools for creating, observing, and controlling Pods. Observation and input tools require an active binding with appropriate scopes.
| Tool | Description | Parameters |
|---|---|---|
| create_pod | Create a new AgentPod | agent_slug (required), runner_id?, ticket_slug?, prompt?, model? |
| get_pod_snapshot | Get a snapshot of another Pod's terminal output (requires pod:read) | pod_key, lines?, raw?, include_screen? |
| send_pod_input | Send text and/or key presses to another Pod (requires pod:write) | pod_key, text?, keys? |
| get_pod_status | Get the agent execution status of a Pod (executing/waiting/idle) | pod_key |
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? |
Loop Tools
Tools for managing automated loops — repeatable tasks that can be triggered manually or via cron scheduling.
| Tool | Description | Parameters |
|---|---|---|
| list_loops | List automated loops in the organization | status?, query?, limit?, offset? |
| trigger_loop | Manually trigger a loop run | loop_slug (required), variables? |