thodr-mcp

A local MCP (Model Context Protocol) server that lets an AI coding assistant (Cursor, Claude Desktop, GitHub Copilot, or any MCP-compatible IDE) create and manage Thodr mock API projects and endpoints on your behalf, by forwarding tool calls to Thodr's existing management REST API.

This server is not an AI model. It does not run any inference itself — it is a thin, local process that validates inputs and makes REST calls to THODR_API_URL using your personal access token. The IDE/agent supplies the model; this server just exposes 5 specific tools that wrap Thodr's projects/routes API. It does not "understand" OpenAPI specs, generate mock data, or do anything beyond what each tool's description says.

Getting a THODR_TOKEN

Thodr authenticates management API calls (and this server) with a Personal Access Token (PAT).

1. Log in to the Thodr web app and go to Settings → Access Tokens.
2. Give the token a name (e.g. my-ide) and click Generate.
3. Copy the token shown in the amber box (it looks like thodr_pat_...). It is shown once and cannot be retrieved again — store it securely (e.g. your OS keychain or IDE's secret storage).

Prefer the API instead? While logged in, call POST {THODR_API_URL}/auth/tokens with your session's bearer (JWT) token and a JSON body {"name": "my-ide"}:

curl -X POST https://thodr.com/api/auth/tokens \
  -H "Authorization: Bearer <your-jwt-from-the-logged-in-session>" \
  -H "Content-Type: application/json" \
  -d '{"name": "my-ide"}'

IDE configuration

Add an MCP server entry to your IDE's MCP config. The exact file location differs by client — check your client's own MCP documentation (e.g. Cursor's or Claude Desktop's settings docs) for where this JSON block goes:

{
  "mcpServers": {
    "thodr": {
      "command": "uvx",
      "args": ["thodr-mcp"],
      "env": {
        "THODR_API_URL": "https://thodr.com/api",
        "THODR_TOKEN": "thodr_pat_xxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

If THODR_TOKEN is missing or empty, the server fails fast at startup with a clear error on stderr instead of failing confusingly on the first tool call.

The 5 tools

This is a read + create only v1 — there are no delete tools. Manage deletion (or anything else not listed below) from the Thodr web app.

Cost and privacy

• $0 to run. This server does no AI inference — it's a local process that makes plain REST calls within your existing Thodr plan's limits.
• Your THODR_TOKEN is sent only to THODR_API_URL as an Authorization: Bearer header. It is never logged, printed, or included in any error message this server produces.

Local development

cd mcp-server
python3 -m venv .venv && source .venv/bin/activate   # or: virtualenv -p python3.12 .venv
pip install -e ".[dev]"
pip install pytest pytest-asyncio respx   # if the [dev] extra doesn't pull these in on your pip version
pytest tests/ -v
python -m thodr_mcp