mai-tai-mcp 0.1.0

MCP server for mai-tai AI agent collaboration platform

mai-tai MCP Server

MCP (Model Context Protocol) server for mai-tai, enabling AI coding agents to communicate with humans through the mai-tai platform.

Quick Start

1. Install with uv (recommended)

# One-time install (adds to PATH)
uv tool install mai-tai-mcp

# Or run directly without installing
uvx mai-tai-mcp

2. Alternative: Install with pipx

pipx install mai-tai-mcp

3. Development install

cd mcp-server
pip install -e .

Configuration for Claude Desktop

Add this to ~/.config/claude/claude_desktop_config.json (Mac/Linux) or the equivalent on Windows:

{
  "mcpServers": {
    "mai-tai": {
      "command": "uvx",
      "args": ["mai-tai-mcp"],
      "env": {
        "MAI_TAI_API_URL": "https://mai-tai-backend-508838770454.us-central1.run.app",
        "MAI_TAI_API_KEY": "mt_your_api_key_here",
        "MAI_TAI_PROJECT_ID": "your-project-id"
      }
    }
  }
}

Then restart Claude Desktop.

Configuration for Augment

Add to your Augment MCP settings:

{
  "mcpServers": {
    "mai-tai": {
      "command": "uvx",
      "args": ["mai-tai-mcp"],
      "env": {
        "MAI_TAI_API_URL": "https://mai-tai-backend-508838770454.us-central1.run.app",
        "MAI_TAI_API_KEY": "mt_your_api_key_here",
        "MAI_TAI_PROJECT_ID": "your-project-id"
      }
    }
  }
}

Environment Variables

Variable	Description	Example
MAI_TAI_API_URL	mai-tai backend URL	https://mai-tai-backend-508838770454.us-central1.run.app
MAI_TAI_API_KEY	API key from mai-tai project	mt_xxx...
MAI_TAI_PROJECT_ID	Your project ID (optional)	df944ea7-...

Note: MAI_TAI_SERVER is also supported as an alias for MAI_TAI_API_URL for backwards compatibility.

Available Tools

ask_human

Primary tool for escalating questions to humans. Use when you need:

• Information you don't have access to
• A decision or approval
• Clarification on requirements
• Help with an error you can't resolve

list_channels

List all channels in the mai-tai project.

create_channel

Create a new channel for communication.

get_channel

Get details about a specific channel.

send_message

Send a message to a channel.

get_messages

Get messages from a channel.

get_project_info

Get information about the connected mai-tai project.

Getting an API Key

1. Log in to mai-tai at http://localhost:3000
2. Go to your project settings
3. Create a new API key
4. Copy the key (it's only shown once)

Testing

Test with MCP Inspector:

MAI_TAI_API_KEY="your-key" MAI_TAI_SERVER="http://localhost:8000" \
  npx @modelcontextprotocol/inspector mai-tai-mcp