MCP Quickstart

Add the AI Coach MCP server to your agent (Claude Code, Cursor, Codex, Zed) and call six read-only tools against the skill library, marketplace, and LLM catalog.

What you get

  • search_skills — search the skill library by free text or category
  • get_skill — full SKILL.md content + install command
  • install_skill — copy-paste install command tailored per agent
  • search_marketplace — MCP servers + curated products
  • list_models — every LLM with cost + context window
  • compare_models — side-by-side matrix

Plus two prompts (find-skill-for, compare-models-for-task) and resources for skill markdown and the model catalog.

Endpoint

POST https://aicoach.pw/api/mcp/v1
Content-Type: application/json
# Authorization: Bearer mcp_xxx   (optional in v1, reserved for paid tools later)

Install in 30 seconds

The shortest path is the /connect/mcp page — it gives you ready-to-paste config for each client. Or grab them here:

Claude Code

{
  "mcpServers": {
    "aicoach": {
      "url": "https://aicoach.pw/api/mcp/v1",
      "transport": "http"
    }
  }
}

Cursor

{
  "mcpServers": {
    "aicoach": { "url": "https://aicoach.pw/api/mcp/v1" }
  }
}

Codex CLI

[mcp_servers.aicoach]
type = "http"
url = "https://aicoach.pw/api/mcp/v1"

Zed

{
  "context_servers": {
    "aicoach": { "transport": "http", "url": "https://aicoach.pw/api/mcp/v1" }
  }
}

Sanity-check from a terminal

# List the tools
curl -sX POST https://aicoach.pw/api/mcp/v1 \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | jq

# Search the skill library
curl -sX POST https://aicoach.pw/api/mcp/v1 \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search_skills","arguments":{"q":"code review","limit":3}}}' | jq

# Compare three models
curl -sX POST https://aicoach.pw/api/mcp/v1 \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"compare_models","arguments":{"ids":["ai-gateway:anthropic/claude-sonnet-4-6","ai-gateway:openai/gpt-5","ai-gateway:google-ai-studio/gemini-2.0-flash"]}}}' | jq

What's not in v1

  • No paid tools — running nano apps and model bake-offs ship in a later release.
  • No write operations — you can't publish skills or MCP servers via the protocol yet.
  • No ACP CLI for Zed — that lands in its own package.

Next steps

  • /connect/mcp — copy-paste configs per client
  • /skills — browse the full skill library
  • /mcp — browse the MCP server marketplace
  • /docs/api — full REST API reference