Documentation Index Fetch the complete documentation index at: https://docs.tracecat.com/llms.txt
Use this file to discover all available pages before exploring further.
Self-host your own instance or join Tracecat Community Cloud.
The easiest way to get started is to connect your agent harness (Claude Code, Cursor, OpenAI Codex) to Tracecat.
Self-host
Docker Compose is the easiest way to self-host.
Check out the full guide here or follow the quickstart below.
# Setup environment variables and secrets
curl -o env.sh https://raw.githubusercontent.com/TracecatHQ/tracecat/1.0.0-beta.43/env.sh
curl -o .env.example https://raw.githubusercontent.com/TracecatHQ/tracecat/1.0.0-beta.43/.env.example
chmod +x env.sh && ./env.sh
# Download Caddyfile
curl -o Caddyfile https://raw.githubusercontent.com/TracecatHQ/tracecat/1.0.0-beta.43/Caddyfile
# Download Docker Compose file
curl -o docker-compose.yml https://raw.githubusercontent.com/TracecatHQ/tracecat/1.0.0-beta.43/docker-compose.yml
# Start Tracecat
docker compose up -d
Connect MCP
Replace <your-tracecat-url> with your PUBLIC_APP_URL (e.g. http://localhost or https://tracecat.example.com).
Claude Code
OpenAI Codex
GitHub Copilot
Cursor
claude mcp add -t http tracecat < your-tracecat-ur l > /mcp
claude
/mcp
codex mcp add tracecat --url < your-tracecat-ur l > /mcp
codex mcp login tracecat
copilot
/mcp add
# Server Name: tracecat
# Server Type: HTTP
# URL: <your-tracecat-url>/mcp
# Tools: *
Follow GitHub Copilot MCP setup for the latest CLI prompts. Or add this server to ~/.copilot/mcp-config.json: {
"mcpServers" : {
"tracecat" : {
"type" : "http" ,
"url" : "<your-tracecat-url>/mcp" ,
"tools" : [ "*" ]
}
}
}
Configure in .cursor/mcp.json: {
"mcpServers" : {
"tracecat" : {
"url" : "<your-tracecat-url>/mcp"
}
}
}
Cloud
Subscription required
Connecting your agent to Tracecat Cloud automatically creates an account for you.
You can also sign up manually via https://platform.tracecat.com .
Claude Code
OpenAI Codex
GitHub Copilot
Cursor
claude mcp add -t http tracecat https://platform.tracecat.com/mcp
claude
/mcp
codex mcp add tracecat --url https://platform.tracecat.com/mcp
codex mcp login tracecat
copilot
/mcp add
# Server Name: tracecat
# Server Type: HTTP
# URL: https://platform.tracecat.com/mcp
# Tools: *
Follow GitHub Copilot MCP setup for the latest CLI prompts. Or add this server to ~/.copilot/mcp-config.json: {
"mcpServers" : {
"tracecat" : {
"type" : "http" ,
"url" : "https://platform.tracecat.com/mcp" ,
"tools" : [ "*" ]
}
}
}
Click this link Add Tracecat to Cursor
Or manually configure in .cursor/mcp.json: {
"mcpServers" : {
"tracecat" : {
"url" : "https://platform.tracecat.com/mcp"
}
}
}