Skip to main content

MCP server

tiden-mcp-server starts a stdio Model Context Protocol server. MCP-capable clients can call Tiden through a tool interface instead of shelling out to individual CLI commands.

The MCP server is distributed from the public qase-tms/tiden-mcp-server repository.

Install​

Download a prebuilt binary from the latest GitHub release, or install from source:

go install github.com/qase-tms/tiden-mcp-server/cmd/tiden-mcp-server@latest

Start the server​

tiden-mcp-server

The server uses the same config resolution as the CLI:

  1. ~/.tiden/config.json
  2. TIDEN_* environment variables
  3. Flags such as --base-url, --api-token, --workspace-id, and --timeout

If you already ran tiden setup, the MCP server can reuse the same ~/.tiden/config.json.

Stdout is reserved for the MCP protocol. Diagnostics go to stderr.

Register with Claude Code​

claude mcp add tiden -- tiden-mcp-server

Typical tools​

The MCP server exposes read operations and safe creates over the public API, including:

  • whoami
  • list_workspaces
  • list_products
  • list_requirements
  • get_requirement
  • create_requirement
  • update_requirement
  • list_tests
  • get_test
  • list_branches
  • create_branch
  • get_merge_preview
  • list_components
  • list_environments
  • list_releases
  • gate_check
  • get_verdict
  • get_overview
  • get_traceability
  • create_test
  • update_test
  • link_requirement
  • list_issues
  • get_issue
  • list_issue_events
  • get_issue_event
  • get_issue_event_stats
  • get_issue_fix_context
  • list_release_issues
  • set_issue_status

Tool output is compact JSON matching the REST response shapes.

get_issue_fix_context returns the issue, its symbolicated stack frames, the repository files those frames implicate, where the error is happening by environment, and whether a test already covers the requirements those files implement. Prefer it over calling get_issue, get_issue_event_stats, and the requirement tools separately. See Triage issues with an agent.

Security​

The MCP server runs locally and uses your API token. Treat any MCP client with access to it as able to perform the exposed Tiden actions for that token.