TCSoftInc/testcollab-mcp-server

Connect your AI coding assistant to TestCollab — manage test cases, test plans, and suites directly from Claude, Cursor, Windsurf, Codex, or any MCP-compatible client.
Quick Start
1. Get your API token
Log in to TestCollab → **My Profile Settings** → **API Token** tab → **Generate new API token**.
2. Add the server to your MCP client
**Claude Code** — add to .mcp.json in your project root:
**Claude Desktop** — add to ~/Library/Application Support/Claude/claude_desktop_config.json:
**Codex** - register TestCollab from the command line:
Or add the server to ~/.codex/config.toml for all projects, or .codex/config.toml in a trusted project:
Run codex mcp list to confirm the server is configured. See the official Codex MCP documentation for configuration scopes and additional options.
**Cursor** — add to .cursor/mcp.json in your project root:
Manual Testing
Available Tools
list_test_cases
List test cases from a project with optional filtering.
**Parameters:**
| Name | Type | Required | Description |
|------|------|----------|-------------|
| project_id | number | No* | Project ID (*required if TC_DEFAULT_PROJECT not set) |
| suite | number\|string | No | Filter by suite ID or title |
| filter | object | No | Filter conditions |
| sort | array | No | Sort specification |
| limit | number | No | Max results (1-100, default: 50) |
| offset | number | No | Skip N results (default: 0) |
3. Verify
Restart your client, then ask: *"What tools do you have for TestCollab?"*
You should see the TestCollab tools listed. Try: *"Show me all test cases"*.
Configuration
| Variable | Required | Default | Description |
|----------|----------|---------|-------------|
| TC_API_TOKEN | Yes | — | API token from your TestCollab profile |
| TC_API_URL | No | https://api.testcollab.io | TestCollab API base URL |
| TC_DEFAULT_PROJECT | No | — | Default project ID (makes project_id optional in every tool call) |
> **EU region:** If your TestCollab account is hosted in the EU, use https://api-eu.testcollab.io as your TC_API_URL.
What You Can Do
| Tool | Description |
|------|-------------|
| **get_project_context** | Get suites, tags, custom fields, requirements, test plan folders, releases, users — call this first |
| **list_test_cases** | Query test cases with filtering, sorting, and pagination |
| **get_test_case** | Fetch a test case with full step details |
| **create_test_case** | Create a test case with steps, tags, custom fields |
| **update_test_case** | Update any test case field |
| **list_test_plans** | List test plans with filtering/sorting (including release ID/title filters) |
| **get_test_plan** | Fetch one test plan with included test cases count, configurations, runs, current progress status, and release info |
| **create_test_plan** | Create a test plan with cases, configurations, assignment, and optional release association |
| **update_test_plan** | Update test plan metadata, status, assignment, and release association |