Pealboard MCP server

Search, read and change issues and portal requests from an assistant, with your own permissions.

What you need

The endpoint https://mcp.pealboard.com/mcp and a Pealboard API key. Create a key at https://app.pealboard.com/settings/api-keys — it is shown once. A key acts with the role of the member who issued it, narrowed by whatever scopes it was given.

If the key's owner belongs to more than one workspace, add an X-Workspace-Id header naming the one you mean. With a single membership it is filled in for you.

Claude Code

claude mcp add --transport http pealboard https://mcp.pealboard.com/mcp \
  --header "Authorization: Bearer pb_your_key"

Claude Desktop and claude.ai

Settings → Connectors → Add custom connector, with the URL https://mcp.pealboard.com/mcp. Sending an API key as a header needs the static_headers option, which Anthropic has in a limited beta; until your organization has it, use Claude Code or Cursor. OAuth 2.1 is planned for this server and is what will make the custom connector work everywhere.

Cursor

In ~/.cursor/mcp.json, or the project's .cursor/mcp.json:

{
  "mcpServers": {
    "pealboard": {
      "url": "https://mcp.pealboard.com/mcp",
      "headers": { "Authorization": "Bearer ${env:PEALBOARD_API_KEY}" }
    }
  }
}

VS Code

{
  "servers": {
    "pealboard": {
      "type": "http",
      "url": "https://mcp.pealboard.com/mcp",
      "headers": { "Authorization": "Bearer ${input:pealboard-key}" }
    }
  }
}

A client with no remote support

Bridge it with mcp-remote. Every client listed above speaks remote HTTP itself, so this is a fallback:

{
  "mcpServers": {
    "pealboard": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://mcp.pealboard.com/mcp",
        "--header", "Authorization: Bearer pb_your_key"
      ]
    }
  }
}

What the connection is

Transport

Stateless Streamable HTTP. POST only — there is no GET stream and no SSE endpoint.

Authentication

Authorization: Bearer pb_…, forwarded to the Pealboard API unchanged. This server stores nothing.

Limit

120 requests a minute per API key.

Discovery

/.well-known/oauth-protected-resource, /health

Documentation: https://pealboard.com/developers/mcp