MCP Server

Wrapd exposes your endpoints as an MCP (Model Context Protocol) server, so AI assistants like Claude Desktop, Claude Code, and Cursor can call your endpoints as tools.

Requirements

• Pro or Team plan
• At least one API key
• One or more non-sensitive endpoints

How it works

Each non-sensitive endpoint becomes an MCP tool. When an AI assistant calls a tool, Wrapd executes the corresponding endpoint and returns the output.

AI Assistant → MCP protocol → Wrapd API → Tunnel/Hosted → Agent → command output

Endpoints marked sensitive: true are excluded from the MCP tool list.

Server URL

https://api.wrapd.sh/mcp

For local development:

http://localhost:7502/mcp

Configuration

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%/Claude/claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "wrapd": {
      "url": "https://api.wrapd.sh/mcp",
      "headers": {
        "X-API-Key": "your-api-key"
      }
    }
  }
}

Claude Code

Add to your project’s .mcp.json or ~/.claude.json:

{
  "mcpServers": {
    "wrapd": {
      "type": "url",
      "url": "https://api.wrapd.sh/mcp",
      "headers": {
        "X-API-Key": "your-api-key"
      }
    }
  }
}

Cursor

Add to your MCP configuration in Cursor settings:

{
  "mcpServers": {
    "wrapd": {
      "url": "https://api.wrapd.sh/mcp",
      "headers": {
        "X-API-Key": "your-api-key"
      }
    }
  }
}

Authentication

MCP connections authenticate with an API key via the X-API-Key header. The same scoping rules apply — if your API key is scoped to specific endpoints, only those endpoints appear as tools.

Tool mapping

Endpoints map to tools as follows:

Endpoint property	MCP tool property
slug	Tool name
description	Tool description
args[].name	Input parameter name
args[].description	Parameter description
args[].required	Whether parameter is required

API key scoping

If your API key has scopes (restricted to certain endpoints), only those endpoints appear as MCP tools. Unscoped keys expose all non-sensitive endpoints.

Dashboard

View your MCP server configuration, available tools, and connection snippets at MCP in the dashboard sidebar.

Testing

Test the MCP connection with curl:

curl -X POST https://api.wrapd.sh/mcp \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2025-03-26",
      "capabilities": {},
      "clientInfo": { "name": "test", "version": "1.0.0" }
    }
  }'