MCP Server

otterkit mcp runs a Model Context Protocol server over stdio, exposing tunnels, webhooks, capture logs, await, and replay as native tools for AI agents. Claude Code, Cursor, and any MCP client can provision endpoints, wait for webhooks, and replay requests without shelling out to the CLI — same account, same credits, same otterkit login.

Setup

Claude Code:

bash

claude mcp add otterkit -- npx otterkit mcp

Cursor / other MCP clients — add to the client's MCP config (e.g. .cursor/mcp.json):

json

{
  "mcpServers": {
    "otterkit": {
      "command": "npx",
      "args": ["otterkit", "mcp"]
    }
  }
}

Log in once with npx otterkit login (or set OTTERKIT_TOKEN for headless machines) — every MCP tool authenticates with the same saved credentials.

Tools

text

webhook_create    Provision a public webhook capture endpoint (background daemon)
tunnel_create     Expose a local port on a public URL (optionally with capture + Basic auth)
sessions_list     List running tunnel/webhook daemons on this machine
session_stop      Stop a daemon (capture log is kept)
requests_list     Read captured requests, filtered by method/path/status
request_await     Block until a matching request arrives — the assertion primitive
request_replay    Re-send a captured request to localhost, with JSON body edits
try_claim         Continue a session started on otterkit.com/try
account_status    Logged-in account + credit balance

The killer combo for agents: webhook_create → point a provider's webhook at the returned URL → request_await as the assertion that the event arrived → request_replay against localhost while iterating on the handler. End-to-end webhook development without leaving the agent loop.

CLI Setup Agent Skill