Arc Todo

Python FastAPI MCP server for Arc Todo. Exposes Streamable HTTP MCP at /mcp and wraps the existing Arc Todo REST API for tasks, knowledge, and workspace context.

Prerequisites

• Python 3.11+
• Running arc-todo-api

Setup

cd arc-todo-mcp
python -m venv .venv
.venv\Scripts\activate
pip install -e ".[dev]"
cp .env.example .env

Environment variables

Variable	Default	Purpose
PORT	8000	HTTP port
ARC_TODO_API_BASE_URL	http://localhost:3000	Arc Todo API base URL
ARC_TODO_USERNAME	—	Service account username
ARC_TODO_PASSWORD	—	Service account password
ARC_TODO_ACCESS_TOKEN	—	Optional pre-issued bearer token
MCP_TOOL_SETTINGS_REFRESH_ON_START	true	Load enabled tools from API on startup
RAG_API_BASE_URL	http://localhost:8020	Arc Todo RAG service base URL
RAG_TIMEOUT_SECONDS	30	RAG HTTP request timeout
RAG_TOP_K	5	Default max chunks when not specified in tool call
RAG_MAX_CONTEXT_TOKENS	4000	Default context token budget when not specified

Run locally

uvicorn app.main:app --reload --port 8000

Endpoints:

• GET /health → { "status": "ok" }
• POST /mcp → Streamable HTTP MCP transport

Configure enabled tools in the web app at /settings/mcp-tools, then restart this service so MCP discovery reflects the saved settings.

Tests

pytest

Deployment

See coolify.md.