MCP

The Recoup API exposes an MCP server that AI agents can connect to for tool use. The server is available at:

https://api.recoupable.dev/mcp

Authentication

All MCP tools require an API key. Pass it as a Bearer token in the Authorization header when connecting to the MCP server.

You can get a key from the API Keys page.

Tools

prompt_sandbox

Send a prompt to OpenClaw running in a persistent per-account sandbox. The sandbox is reused across calls — if one is already running it picks up where you left off, otherwise a new one is created from the account's latest snapshot.

Returns raw stdout and stderr from the command. The sandbox stays alive after each prompt for follow-up interactions.

Input schema:

Response fields:

Example usage (TypeScript with MCP SDK):

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";

const transport = new StreamableHTTPClientTransport(
  new URL("https://api.recoupable.dev/mcp"),
  { requestInit: { headers: { Authorization: `Bearer ${RECOUP_API_KEY}` } } },
);

const client = new Client({ name: "my-agent", version: "1.0.0" });
await client.connect(transport);

const result = await client.callTool({
  name: "prompt_sandbox",
  arguments: { prompt: "list all files in the orgs directory" },
});

console.log(result.content);

run_sandbox_command

Create a sandbox and run a shell command or OpenClaw prompt in it. Unlike prompt_sandbox, this creates a new sandbox each call and runs the command asynchronously via a background task. Returns a sandbox ID and run ID to track progress.

See POST /api/sandboxes for the equivalent REST endpoint.

Input schema: