Is a project ID required for every request?

A project_id is required when TC_DEFAULT_PROJECT is not set.

Which TestCollab API regions are supported?

The default API URL is https://api.testcollab.io. EU-hosted accounts can use https://api-eu.testcollab.io.

Which MCP clients are documented?

The README provides configuration examples for Claude Desktop, Cursor, and also references Claude Code and Windsurf.

Testcollab MCP Server

testcollabtestingtest-managementdeveloper-tools

Manage TestCollab test cases, plans, and suites from MCP-compatible coding assistants.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

We couldn’t automatically confirm this listing starts correctly

We ran the install command below but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

npx -y @testcollab/mcp-server

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 1mo ago.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "tcsoftinc-testcollab-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@testcollab/mcp-server"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Overview

This server connects MCP clients to TestCollab for managing test cases, test plans, and suites. Use it to query, create, update, organize, and inspect testing data with filtering, sorting, and pagination support.

Use cases

List test cases with filters, sorting, and pagination

Create test cases with steps, tags, and custom fields

Update test cases and test plan metadata

Create and manage test plans and suites

Move or reorder test suites

Key features

Test case listing, retrieval, creation, and updates

Test plan creation, retrieval, updates, and deletion

Suite creation, updates, deletion, movement, and reordering

Filtering and sorting for test cases and test plans

Pagination for test case queries

Project context retrieval for suites, tags, fields, requirements, and releases

Capabilities & Tool Schemas (6)Self-reported

Inspect callable tools, capabilities, and parameters exposed to AI agents by Testcollab MCP Server.

project_id

Project ID (*required if `TC_DEFAULT_PROJECT` not set)

suite

filter

Filter conditions

sort

Sort specification

limit

Max results (1-100, default: 50)

offset

Skip N results (default: 0)

Documentation Overview

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

2. Add the server to your MCP client

Claude Code — add to .mcp.json in your project root:

config.json

{
  "mcpServers": {
    "testcollab": {
      "command": "npx",
      "args": ["-y", "@testcollab/mcp-server"],
      "env": {
        "TC_API_TOKEN": "your-api-token",
        "TC_API_URL": "https://api.testcollab.io",
        "TC_DEFAULT_PROJECT": "16"
      }
    }
  }
}

Claude Desktop — add to ~/Library/Application Support/Claude/claude_desktop_config.json:

config.json

{
  "mcpServers": {
    "testcollab": {
      "command": "npx",
      "args": ["-y", "@testcollab/mcp-server"],
      "env": {
        "TC_API_TOKEN": "your-api-token",
        "TC_API_URL": "https://api.testcollab.io",
        "TC_DEFAULT_PROJECT": "16"
      }
    }
  }
}

Codex - register TestCollab from the command line:

bash

codex mcp add testcollab \
  --env TC_API_TOKEN=your-api-token \
  --env TC_API_URL=https://api.testcollab.io \
  --env TC_DEFAULT_PROJECT=16 \
  -- npx -y @testcollab/mcp-server

Or add the server to ~/.codex/config.toml for all projects, or .codex/config.toml in a trusted project:

toml

[mcp_servers.testcollab]
command = "npx"
args = ["-y", "@testcollab/mcp-server"]

[mcp_servers.testcollab.env]
TC_API_TOKEN = "your-api-token"
TC_API_URL = "https://api.testcollab.io"
TC_DEFAULT_PROJECT = "16"

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:

config.json

{
  "mcpServers": {
    "testcollab": {
      "command": "npx",
      "args": ["-y", "@testcollab/mcp-server"],
      "env": {
        "TC_API_TOKEN": "your-api-token",
        "TC_API_URL": "https://api.testcollab.io",
        "TC_DEFAULT_PROJECT": "16"
      }
    }
  }
}

Manual Testing

bash

TC_API_TOKEN=your-token npm start

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
delete_test_plan	Delete a test plan
list_suites	List all test suites in a project (supports `title`, `parent`, and `description` filters)
get_suite	Get suite details
create_suite	Create a new suite
update_suite	Update a suite
delete_suite	Delete a suite
move_suite	Move a suite to a different parent
reorder_suites	Reorder suites within a parent

Example Prompts

Code

"Show me all high-priority test cases in the Login suite"

"Create a test case for verifying password reset with 5 steps"

"List all test plans created this week"

"Create a regression test plan with all test cases tagged 'smoke'"

"Move the Payment suite under the Checkout suite"

See Use Cases for detailed workflows.

Local Development Setup

If you're contributing or want to run from source instead of npx:

bash

git clone <repo-url>
cd tc-mcp-server
npm install
npm run build

Then point your MCP client to the built file:

config.json

{
  "mcpServers": {
    "testcollab": {
      "command": "node",
      "args": ["/path/to/tc-mcp-server/dist/index.js"],
      "env": {
        "TC_API_TOKEN": "your-api-token",
        "TC_API_URL": "http://localhost:1337",
        "TC_DEFAULT_PROJECT": "16"
      }
    }
  }
}

Dev Commands

Terminal

npm run dev          # Watch mode with hot reload
npm run build        # Compile TypeScript
npm test             # Run tests
npm run typecheck    # Type check
npm run lint         # Lint

Troubleshooting

Server not appearing in your client

Restart the client after adding the config
Verify Node.js 20+ is installed: node --version
Test manually: TC_API_TOKEN=your-token npx @testcollab/mcp-server

Authentication errors

Verify your API token is valid and not expired
Check that TC_API_URL points to the correct server

"project_id is required" error

Set TC_DEFAULT_PROJECT in your env config, or
Specify the project in your prompt: "Show me test cases in project 16"

License

MIT

Read the full README →View source on GitHub →

Related MCP Servers

View all in Developer Tools View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

npm downloads

251

Package downloads in the last 30 days.

Last commit

15d ago

Most recent push to the default branch.

Install check

Inconclusive

Didn't respond in our test window — often a slow first install.

Tools exposed

Callable tools this server registers over MCP.

Directory activity

2 views

Config copies, upvotes, and views on AllMCPs.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Testcollab MCP Server

It requires a TestCollab API token configured in TC_API_TOKEN.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Testcollab MCP Server AllMCPs Directory Badge

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/tcsoftinc-testcollab-mcp-server?style=directory)](https://allmcps.com/mcp/tcsoftinc-testcollab-mcp-server)

HTML Embed

<a href="https://allmcps.com/mcp/tcsoftinc-testcollab-mcp-server"><img src="https://allmcps.com/api/badge/tcsoftinc-testcollab-mcp-server?style=directory" alt="Testcollab MCP Server on AllMCPs" /></a>

Technical Specs & Signals

CategoryDeveloper Tools

PricingFree

10/11 checks healthy over the last 32d

60Quality signal: Good · 60/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools27/30

Adoption & activity8/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 27d ago via OSV.dev · @testcollab/mcp-server (npm)

★ Featured

AllMCPs Server

The official MCP server for AllMCPs.com - submit and manage tools directly from your AI. The open directory for MCP servers. Connect Claude, Cursor, Windsurf, and AI agents to databases, tools, files, and APIs. Explore 10,000+ servers. AllMCPs is the premier, open directory for discovering, evaluating, and installing Model Context Protocol (MCP) servers to equip AI agents and LLMs with real-world superpowers.

Explore Server →

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💻 Developer Tools →Best MCP servers for Developers →Alternatives to Testcollab MCP Server →Install in Claude Desktop Install in Cursor Install in VS Code

Testcollab MCP Server

testcollabtestingtest-managementdeveloper-tools

Manage TestCollab test cases, plans, and suites from MCP-compatible coding assistants.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

We couldn’t automatically confirm this listing starts correctly

We ran the install command below but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

npx -y @testcollab/mcp-server

No response to initialize.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "tcsoftinc-testcollab-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@testcollab/mcp-server"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Overview

Use cases

List test cases with filters, sorting, and pagination

Create test cases with steps, tags, and custom fields

Update test cases and test plan metadata

Create and manage test plans and suites

Move or reorder test suites

Key features

Test case listing, retrieval, creation, and updates

Test plan creation, retrieval, updates, and deletion

Suite creation, updates, deletion, movement, and reordering

Filtering and sorting for test cases and test plans

Pagination for test case queries

Project context retrieval for suites, tags, fields, requirements, and releases

Capabilities & Tool Schemas (6)Self-reported

Inspect callable tools, capabilities, and parameters exposed to AI agents by Testcollab MCP Server.

project_id

Project ID (*required if `TC_DEFAULT_PROJECT` not set)

suite

filter

Filter conditions

sort

Sort specification

limit

Max results (1-100, default: 50)

offset

Skip N results (default: 0)

Documentation Overview

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

2. Add the server to your MCP client

Claude Code — add to .mcp.json in your project root:

config.json

{
  "mcpServers": {
    "testcollab": {
      "command": "npx",
      "args": ["-y", "@testcollab/mcp-server"],
      "env": {
        "TC_API_TOKEN": "your-api-token",
        "TC_API_URL": "https://api.testcollab.io",
        "TC_DEFAULT_PROJECT": "16"
      }
    }
  }
}

Claude Desktop — add to ~/Library/Application Support/Claude/claude_desktop_config.json:

config.json

{
  "mcpServers": {
    "testcollab": {
      "command": "npx",
      "args": ["-y", "@testcollab/mcp-server"],
      "env": {
        "TC_API_TOKEN": "your-api-token",
        "TC_API_URL": "https://api.testcollab.io",
        "TC_DEFAULT_PROJECT": "16"
      }
    }
  }
}

Codex - register TestCollab from the command line:

bash

codex mcp add testcollab \
  --env TC_API_TOKEN=your-api-token \
  --env TC_API_URL=https://api.testcollab.io \
  --env TC_DEFAULT_PROJECT=16 \
  -- npx -y @testcollab/mcp-server

Or add the server to ~/.codex/config.toml for all projects, or .codex/config.toml in a trusted project:

toml

[mcp_servers.testcollab]
command = "npx"
args = ["-y", "@testcollab/mcp-server"]

[mcp_servers.testcollab.env]
TC_API_TOKEN = "your-api-token"
TC_API_URL = "https://api.testcollab.io"
TC_DEFAULT_PROJECT = "16"

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:

config.json

{
  "mcpServers": {
    "testcollab": {
      "command": "npx",
      "args": ["-y", "@testcollab/mcp-server"],
      "env": {
        "TC_API_TOKEN": "your-api-token",
        "TC_API_URL": "https://api.testcollab.io",
        "TC_DEFAULT_PROJECT": "16"
      }
    }
  }
}

Manual Testing

bash

TC_API_TOKEN=your-token npm start

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
delete_test_plan	Delete a test plan
list_suites	List all test suites in a project (supports `title`, `parent`, and `description` filters)
get_suite	Get suite details
create_suite	Create a new suite
update_suite	Update a suite
delete_suite	Delete a suite
move_suite	Move a suite to a different parent
reorder_suites	Reorder suites within a parent

Example Prompts

Code

"Show me all high-priority test cases in the Login suite"

"Create a test case for verifying password reset with 5 steps"

"List all test plans created this week"

"Create a regression test plan with all test cases tagged 'smoke'"

"Move the Payment suite under the Checkout suite"

See Use Cases for detailed workflows.

Local Development Setup

If you're contributing or want to run from source instead of npx:

bash

git clone <repo-url>
cd tc-mcp-server
npm install
npm run build

Then point your MCP client to the built file:

config.json

{
  "mcpServers": {
    "testcollab": {
      "command": "node",
      "args": ["/path/to/tc-mcp-server/dist/index.js"],
      "env": {
        "TC_API_TOKEN": "your-api-token",
        "TC_API_URL": "http://localhost:1337",
        "TC_DEFAULT_PROJECT": "16"
      }
    }
  }
}

Dev Commands

Terminal

npm run dev          # Watch mode with hot reload
npm run build        # Compile TypeScript
npm test             # Run tests
npm run typecheck    # Type check
npm run lint         # Lint

Troubleshooting

Server not appearing in your client

Restart the client after adding the config
Verify Node.js 20+ is installed: node --version
Test manually: TC_API_TOKEN=your-token npx @testcollab/mcp-server

Authentication errors

Verify your API token is valid and not expired
Check that TC_API_URL points to the correct server

"project_id is required" error

Set TC_DEFAULT_PROJECT in your env config, or
Specify the project in your prompt: "Show me test cases in project 16"

License

MIT

Read the full README →View source on GitHub →

Related MCP Servers

View all in Developer Tools View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

npm downloads

251

Package downloads in the last 30 days.

Last commit

15d ago

Most recent push to the default branch.

Install check

Inconclusive

Didn't respond in our test window — often a slow first install.

Tools exposed

Callable tools this server registers over MCP.

Directory activity

2 views

Config copies, upvotes, and views on AllMCPs.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Testcollab MCP Server

It requires a TestCollab API token configured in TC_API_TOKEN.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/tcsoftinc-testcollab-mcp-server?style=directory)](https://allmcps.com/mcp/tcsoftinc-testcollab-mcp-server)

HTML Embed

<a href="https://allmcps.com/mcp/tcsoftinc-testcollab-mcp-server"><img src="https://allmcps.com/api/badge/tcsoftinc-testcollab-mcp-server?style=directory" alt="Testcollab MCP Server on AllMCPs" /></a>

Technical Specs & Signals

CategoryDeveloper Tools

PricingFree

10/11 checks healthy over the last 32d

60Quality signal: Good · 60/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools27/30

Adoption & activity8/15

Community engagement0/10

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 27d ago via OSV.dev · @testcollab/mcp-server (npm)

★ Featured

AllMCPs Server

Explore Server →

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💻 Developer Tools →Best MCP servers for Developers →Alternatives to Testcollab MCP Server →Install in Claude Desktop Install in Cursor Install in VS Code