Model Context Protocol

Your Board, Everywhere

Kardbrd exposes the full board over MCP. Read cards, create tasks, add comments, track progress—from any tool that supports the protocol.

Get Started

Server Configuration

MCP Server

Server URL

https://app.kardbrd.com/mcp/

Transport

HTTP (JSON-RPC)

OAuth 2.0 Authentication (with PKCE)

Authorization Server

https://app.kardbrd.com/oauth

Available Scopes

board:read — Read access to boards, cards, lists, and comments

board:write — Create, update, and delete boards, cards, lists, and comments

Setup Guides

Pick your tool. Paste the config. Authorize once.

Claude Code Recommended

Paste this into your settings. First run triggers OAuth—authorize and you're done.

Add to your MCP settings:

{
  "mcpServers": {
    "kardbrd": {
      "type": "http",
      "url": "https://app.kardbrd.com/mcp/"
    }
  }
}

Run claude mcp add or edit ~/.claude/settings.json directly.

Cursor

Same deal. Drop this into your MCP config, authorize on first connect.

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "kardbrd": {
      "url": "https://app.kardbrd.com/mcp/",
      "transport": "http"
    }
  }
}

Windsurf

Add this to your Windsurf config. OAuth prompt shows up on first connection.

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "kardbrd": {
      "serverUrl": "https://app.kardbrd.com/mcp/"
    }
  }
}

ChatGPT

Four clicks. No config file needed.

Open ChatGPT Settings → Connections
Click "Add MCP Server"
Enter server URL: https://app.kardbrd.com/mcp/
Complete the OAuth authorization flow

Other MCP Clients

Any MCP-compatible tool can connect to Kardbrd. Use these settings:

Server URL: https://app.kardbrd.com/mcp/

Transport: HTTP (JSON-RPC)

Auth: OAuth 2.0 + PKCE (https://app.kardbrd.com/oauth)

Dynamic client registration is supported—no pre-registration required.

Available Tools

The MCP server exposes these tools for interacting with your boards.

Boards

List boards, get board details, view activity. Full read access to everything.

Cards

Create, read, update, move, and archive cards. The full lifecycle, not just read-only.

Checklists

Add checklists to cards, create todo items, mark them complete. Progress stays on the card.

Comments

Add comments, read discussions, react with emoji. Full conversation history available.

Attachments

Attach files and markdown documents to cards. Upload research, plans, or any supporting material.

Links

Connect cards to external resources—PRs, docs, related cards. Build a web of context.

Protocol Features

Dynamic Client Registration

No need to pre-register your application. Connect any MCP client and authorize on the fly.

OAuth 2.0 with PKCE

OAuth 2.0 following OAuth 2.1 security requirements—PKCE enforced, tokens scoped to what you allow, nothing more.

Granular Permissions

Read-only or full access—you control the scope. Revoke anytime from your account settings.

Simple HTTP Transport

Plain JSON-RPC over HTTP. No WebSockets, no streaming complexity. Works everywhere, easy to debug, firewall-friendly.

Context that persists.

Connect once. Every session starts with full board access.

Get Started

Questions? [email protected]