MCP serverStreamable HTTP · Model Context Protocol

Debug with any
AI client.

Corvin exposes an MCP server at /v2/mcp. Connect Claude Code, Claude Desktop, Cursor, or VS Code Copilot. Every tool call runs against your live services in real time.

transportStreamable HTTP (2025)authBearer tokenendpointPOST /v2/mcptools8 available

Connect in
four steps.

01
corvin login
Get your API key

Run corvin login to sign in via the browser. Your key is saved to ~/.corvin/config. Or create one at the dashboard.

02
corvin npm run dev
Start your services

Wrap each service with corvin <cmd>. Logs stream to the local cluster on :4466. The MCP server connects to this.

03
~/.corvin/config
Configure your client

Pick the config for your client below. Paste your API key from ~/.corvin/config. Point the URL at your Corvin server.

04
corvin:tailLogs()
Ask about bugs

Open your client and start asking. Tools execute against your live services in real time — no copy-pasting logs.

Client
configurations.

Get your API key from ~/.corvin/config after corvin login, or from the dashboard.

.claude/settings.json
{
  "mcpServers": {
    "corvin": {
      "type": "http",
      "url": "https://api.usecorvin.space/v2/mcp",
      "headers": {
        "Authorization": "Bearer <your-api-key>"
      }
    }
  }
}
or via CLI
$ claude mcp add --transport http \
  --header "Authorization: Bearer <key>" \
  corvin https://api.usecorvin.space/v2/mcp

Or add via CLI command above. The server can be local or remote (use HTTPS for production).

8 tools.
Zero setup.

Tools are scoped to your session — only services connected under your API key are accessible.

listServices

List all services connected to your Corvin session.

—
tailLogs

Get the last N lines from a service's in-memory logs.

serviceId, n
grepLogs

Search logs for a pattern with before/after context.

serviceId, pattern, before, after
getRecentErrors

Most recent N lines containing ERROR, WARN, FATAL, EXCEPTION.

serviceId, n
readLogs

Paginated log reading (50 lines per page).

serviceId, pageNumber
grepCodeBase

Ripgrep through source code. Returns file path and matching line.

serviceId, searchTerm
readFileContents

Read lines around a specific line number in any source file.

serviceId, filePath, lineNumber, before, after
generateYamlName

Generate a concise project name from a plain-language description.

description

Security
model.

Scoped to your session

MCP tools only reach services connected under your API key. Requesting another user's serviceId returns an access-denied error.

Same key, two paths

The Corvin CLI API key authorises both WebSocket connections and MCP requests. Revoke it in the dashboard to immediately block both.

Local by default

The MCP server runs on your machine at api.usecorvin.space. Nothing is forwarded to a third party. Use HTTPS + a reverse proxy for remote access.

Start asking.
From your editor.

Install Corvin, run your services wrapped, add the MCP config, and your AI client can tail logs and read your code.

Get started →