MCP
Use the hosted RobotRock MCP server to add human-in-the-loop approvals to any MCP-native agent runtime.
Endpoint: https://mcp.robotrock.io/mcp
Tools
| Tool | Description |
|---|---|
send_to_human | Create a task in your RobotRock inbox (returns taskId immediately) |
get_task | Read task status and the human's response |
Authentication (per customer)
Every customer uses their own API key from the RobotRock dashboard (Settings → API Keys). The hosted server validates the key and routes tasks to that customer's tenant.
{
"mcpServers": {
"robotrock": {
"url": "https://mcp.robotrock.io/mcp",
"headers": {
"X-Api-Key": "ll_your_api_key"
}
}
}
}You can also pass Authorization: Bearer ll_your_api_key.
There is no shared server API key — each customer's key identifies their workspace.
Waiting for a human response
SSE push (recommended)
When connected over HTTP MCP:
- Call
send_to_human→ receive{ taskId, delivery: "sse" } - Keep the MCP SSE connection open
- When a human handles the task, the server pushes a notification:
{
"type": "robotrock/task_handled",
"taskId": "task_abc",
"action": { "id": "approve", "title": "Approve", "data": {} },
"handledBy": "alice@acme.com",
"handledAt": "2026-06-07T12:00:00.000Z"
}Polling fallback
Call get_task with the taskId until status is handled. Use this if the SSE connection dropped or your MCP client does not handle server notifications.
Self-hosting (monorepo)
Deploy apps/mcp to Vercel. Required environment variables:
| Variable | Description |
|---|---|
CONVEX_URL | Convex deployment URL (API key validation) |
KV_REST_API_URL / KV_REST_API_TOKEN | Upstash Redis (sessions, SSE queue) |
ROBOTROCK_WEBHOOK_SECRET | Verify inbound webhooks from RobotRock |
ROBOTROCK_MCP_PUBLIC_URL | Public URL of this deployment |
ROBOTROCK_API_BASE_URL | Optional API base (defaults to production) |
Routes:
GET/POST/DELETE /mcp— MCP Streamable HTTPPOST /webhooks/robotrock— RobotRock task handled webhooksGET /health— health check
When to use MCP vs other integrations
| Runtime | Use |
|---|---|
| MCP-native agent host | Hosted MCP (/mcp) |
| Vercel AI SDK | robotrock/ai |
| Trigger.dev worker | robotrock/trigger |
| Vercel Workflow | robotrock/workflow |