Adapts MCP

A lightweight MCP (Model Context Protocol) stdio bridge that connects AI coding assistants to Adapts MCP. Works with any MCP-compatible host — Cursor, Claude Desktop, Claude Code, Windsurf, and more.

Requirements: Python 3.9+

Installation

Download mcp-client.pyz from the latest release. No dependencies required beyond Python 3.9+.

Quick Start

Cursor

Add to your Cursor MCP settings (.cursor/mcp.json in your project or global config):

{
  "mcpServers": {
    "adapts-mcp": {
      "command": "python3",
      "args": ["/path/to/mcp-client.pyz"]
    }
  }
}

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "adapts-mcp": {
      "command": "python3",
      "args": ["/path/to/mcp-client.pyz"]
    }
  }
}

Claude Code

claude mcp add adapts-mcp -- python3 /path/to/mcp-client.pyz

Windsurf

Add to your Windsurf MCP config:

{
  "mcpServers": {
    "adapts-mcp": {
      "command": "python3",
      "args": ["/path/to/mcp-client.pyz"]
    }
  }
}

Authentication

On first run, the bridge opens a browser to adapts.app for OAuth sign-in (Google or Microsoft). After authenticating, your token is stored locally and refreshed automatically. No AWS credentials are needed.

For headless environments (SSH, containers), the auth URL is printed to stderr — open it in any browser to complete sign-in.

Troubleshooting

401 errors — Run mcp-client logout, then restart your MCP host. The bridge will re-authenticate on next launch.
"Could not open a browser" — Copy the URL printed to stderr and open it manually.
"UPDATE REQUIRED" — Download the latest .pyz from adapts.app.

Support

For questions or issues, contact dev@adapts.ai.