fix(mcp): remove MCP tool namespaces

[topher-lo]

Summary

• Register Tracecat MCP tools directly on the main server without FastMCP namespace mounts.
• Regenerate the Tracecat MCP tools docs as a flat list with unprefixed tool names.
• Update Tracecat automation skill guidance and authoring evals/tests to use unprefixed MCP tool names.

Validation

• uv run ruff check tracecat/mcp/server.py scripts/generate_mcp_docs.py scripts/evals/tracecat_authoring/run_local.py tests/unit/test_tracecat_authoring_eval.py tests/unit/test_mcp_server.py
• uv run ruff format --check tracecat/mcp/server.py scripts/generate_mcp_docs.py scripts/evals/tracecat_authoring/run_local.py tests/unit/test_tracecat_authoring_eval.py tests/unit/test_mcp_server.py
• uv run pytest tests/unit/test_tracecat_authoring_eval.py tests/unit/test_mcp_server.py -q
• Commit hooks: ruff, gitleaks, frontend client generation, basedpyright, and MCP docs generation passed.

---

Summary by cubic

Removes MCP tool namespaces and registers all tools directly on the main mcp server with unprefixed names. Updates docs, skills, evals, and tests to the new flat naming.

• Refactors

  • Removed FastMCP namespace mounts and _TOOL_NAMESPACE_BY_NAME; tools are now registered via mcp.tool with simple names.
  • Regenerated MCP tool docs as a flat list; scripts/generate_mcp_docs.py now detects mcp.tool decorators.
  • Updated skill guidance and authoring evals/tests to use unprefixed tool names; added a canonical tool name set in the eval runner.
  • Adjusted unit tests to assert tool presence via attributes instead of namespace mapping.

• Migration

  • Update clients to call unprefixed tools. Rule: strip <namespace>_ from the name.
    • Examples: workspaces_list_workspaces -> list_workspaces, workflows_edit_workflow -> edit_workflow, tables_create_column_index -> create_column_index.
  • No schema changes; only tool names changed.

^{Written for commit 655b619. Summary will update on new commits.}

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
tracecat	🟢 Ready	View Preview	May 30, 2026, 2:51 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

[cubic-dev-ai]

No issues found across 9 files

Confidence score: 5/5

• Automated review surfaced no issues in the provided summaries.
• No files require special attention.

_{Re-trigger cubic}

[zeropath-ai]

✅ No security or compliance issues detected. Reviewed everything up to 655b619.

Security Overview

• 🔎 Scanned files: 9 changed file(s)
• 🔗 Scan Link: https://zeropath.com/app/repositories/00dffd6c-8834-4dc9-b6d8-b44cd1622986?scanId=c193f4b7-9700-48f6-ac77-02428c3b3d21&codeScanTypes=PrScan&tab=issues

Detected Code Changes

Change Type	Relevant files
Refactor	► .agents/skills/tracecat-automation-best-practices/SKILL.md     Update workflow tool names to remove workflows_ prefix ► docs/snippets/mcp-tools.mdx     Update workflow tool names to remove workflows_ prefix ► scripts/evals/tracecat_authoring/README.md     Update workspaces_list_workspaces to list_workspaces ► scripts/evals/tracecat_authoring/cases.yaml     Update workflows_get_workflow to get_workflow ► scripts/evals/tracecat_authoring/run_local.py     Update tool names to remove workflows_ prefix     Add TRACECAT_MCP_TOOL_NAMES set for validation ► scripts/generate_mcp_docs.py     Remove namespace handling and _TOOL_NAMESPACE_BY_NAME extraction ► tests/unit/test_mcp_server.py     Update tests for removed namespace mapping ► tests/unit/test_tracecat_authoring_eval.py     Update tool name in test
Enhancement	► .agents/skills/tracecat-automation-best-practices/SKILL.md     Update action names in documentation for consistency

[daryllimyt]

lgtm