tracecat-mcp-community
A full-stack Model Context Protocol (MCP) server for the Tracecat SOAR platform — 94 tools across 16 domains.
Power your agent
Install from the publisher. Not a PlugMCP endpoint.
Host a copy with our keys and logs.
No packaged release in the registry yet. Follow the repository README.
Remote URL or a command on your machine? How the two installs differ
Run on PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
LaunchFrom the publisher
A full-stack Model Context Protocol (MCP) server for the Tracecat SOAR platform — 94 tools across 16 domains.
MCP server for Tracecat SOAR platform — 44 tools for workflows, actions, cases, executions, secrets, tables, schedules & more
An MCP server that gives AI assistants (Claude Code, Claude Desktop, etc.) full control over a Tracecat instance through natural language. Manage workflows, actions, cases, secrets, tables, schedules, graphs, and more — without leaving your editor.
Tracecat ships an official MCP server (HTTP transport, OIDC auth, bundled with the platform). This community MCP is a standalone alternative you can use instead — pick the one that fits your setup.
You don't need both. This community MCP is designed to cover the full surface on its own.
Total: 94 tools for complete Tracecat automation.
# Install globally
npm install -g tracecat-mcp-community
Create a .env file wherever you run from (or in the package directory):
TRACECAT_API_URL=http://localhost/api
[email protected]
TRACECAT_PASSWORD=your-password-here
TRACECAT_WORKSPACE_ID= # Optional — auto-detected if omitted
Add to your .mcp.json:
{
"mcpServers": {
"tracecat": {
"command": "npx",
"args": ["-y", "tracecat-mcp-community"]
}
}
}
git clone https://github.com/adrojis/tracecat-mcp-community.git
cd tracecat-mcp-community
npm install
cp .env.example .env # Edit with your credentials
npm run build
Add to your .mcp.json:
{
"mcpServers": {
"tracecat": {
"command": "node",
"args": ["/absolute/path/to/tracecat-mcp-community/dist/index.js"]
}
}
}
git clone https://github.com/adrojis/tracecat-mcp-community.git
cd tracecat-mcp-community
docker build -t tracecat-mcp-community .
{
"mcpServers": {
"tracecat": {
"command": "docker",
"args": ["run", "-i", "--rm", "--env-file", "/path/to/.env", "tracecat-mcp-community"]
}
}
}
Security:
.envis gitignored and never committed. Never hardcode credentials in source files. See SECURITY.md.
Then restart Claude Code and verify with /mcp — you should see the tracecat server with 94 tools.
Credentials are loaded from .env via dotenv. The .env file must be in the project root (next to package.json).
src/
├── index.ts # Entry point — StdioTransport + env loading
├── server.ts # McpServer creation + tool registration
├── client.ts # HTTP client with lazy auth + auto workspace injection
├── types.ts # TypeScript interfaces
└── tools/
├── workflows.ts # Workflow CRUD + deploy/export/validate/autofix
├── actions.ts # Action CRUD with YAML inputs
├── cases.ts # Case CRUD + comments + tasks + custom fields
├── executions.ts # Run (live + draft), list, cancel, inspect executions
├── secrets.ts # Secret management
├── variables.ts # Non-sensitive workspace variables CRUD
├── tables.ts # Tables, columns, and rows
├── graph.ts # Graph operations (get graph, edges, node positions)
├── folders.ts # Folder CRUD + move workflow into folder
├── workspaces.ts # Workspace CRUD + current-workspace info
├── integrations.ts # OAuth integrations + providers
├── webhooks.ts # Webhook get/update + key rotation
├── schedules.ts # Cron/interval scheduling
├── docs.ts # Documentation search
├── templates.ts # Community workflow templates
└── system.ts # Health check
This server currently authenticates via username/password (session cookies). The Tracecat team is actively working on API token authentication, which will provide a simpler and more secure connection method — no more password in .env.
We will add API token support as soon as it becomes available upstream. The username/password method will remain supported for backward compatibility.
These behaviors differ from typical REST conventions and are handled transparently by the server:
# Watch mode (auto-reload)
npm run dev
# Build TypeScript
npm run build
# Run directly
node dist/index.js
npm run build
npm test
Tests use Node.js built-in test runner (no extra dependencies). See CONTRIBUTING.md for guidelines.
The MCP Inspector is a visual debugging tool that lets you browse and test all 94 tools interactively in your browser — useful for verifying your setup, exploring tool schemas, and testing API calls without Claude.
From the project root:
npx @modelcontextprotocol/inspector node dist/index.js
This starts a local web UI (default: http://localhost:6274). Click the Tools tab to see all available tools, inspect their input schemas, and execute them against your Tracecat instance.
This project is under active development. Tracecat's API surface evolves fast, and we intend to keep up — expect new tools, refinements, and breaking-change adaptations as the platform matures.
Planned areas of improvement:
Contributions, issues, and feature requests are welcome.
Note: This project was previously named
tracecat-mcp. It was renamed totracecat-mcp-communityin April 2026 to distinguish it from Tracecat's official MCP server (HTTP + OIDC), which shipped shortly after.
MCP server for Tracecat SOAR platform — 44 tools for workflows, actions, cases, executions, secrets, tables, schedules & more
Tools
No tool list yet. Remote servers get one after the first health check.
FAQ
Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.
No required environment variable is listed on this record.
Tracecat MCP Community runs locally over stdio.
Last checked 2026-10-27. MCP server for Tracecat SOAR platform — 44 tools for workflows, actions, cases, executions, secrets, tables, schedules & more