mcp-testpad

MCP server for the TestPad test case management API. Gives AI assistants access to your TestPad projects, folders, scripts, test runs, and notes — 15 tools in total.

Prerequisites

• Node.js >= 18
• A TestPad account with API access enabled (contact TestPad support)
• An API token generated by your account owner

Getting an API Token

API tokens are generated by the account holder. Contact christopher.sabroe@framna.com to request access to one or more projects.

Setup

Claude Code

claude mcp add testpad -e TESTPAD_API_TOKEN=your_token_here -- npx -y github:shapehq/mcp-testpad

Then restart Claude Code.

Claude Desktop

Add to your config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "testpad": {
      "command": "npx",
      "args": ["-y", "github:shapehq/mcp-testpad"],
      "env": {
        "TESTPAD_API_TOKEN": "your_token_here"
      }
    }
  }
}

OpenAI Codex CLI

codex mcp add testpad --env TESTPAD_API_TOKEN=your_token_here -- npx -y github:shapehq/mcp-testpad

Or add to ~/.codex/config.toml:

[mcp_servers.testpad]
command = "npx"
args = ["-y", "github:shapehq/mcp-testpad"]

[mcp_servers.testpad.env]
TESTPAD_API_TOKEN = "your_token_here"

Cursor

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project):

{
  "mcpServers": {
    "testpad": {
      "command": "npx",
      "args": ["-y", "github:shapehq/mcp-testpad"],
      "env": {
        "TESTPAD_API_TOKEN": "your_token_here"
      }
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "testpad": {
      "command": "npx",
      "args": ["-y", "github:shapehq/mcp-testpad"],
      "env": {
        "TESTPAD_API_TOKEN": "your_token_here"
      }
    }
  }
}

VS Code (Copilot)

Add to .vscode/mcp.json in your workspace:

{
  "servers": {
    "testpad": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "github:shapehq/mcp-testpad"],
      "env": {
        "TESTPAD_API_TOKEN": "your_token_here"
      }
    }
  }
}

JetBrains IDEs

Go to Settings > Tools > AI Assistant > Model Context Protocol (MCP), click Add, and paste:

{
  "mcpServers": {
    "testpad": {
      "command": "npx",
      "args": ["-y", "github:shapehq/mcp-testpad"],
      "env": {
        "TESTPAD_API_TOKEN": "your_token_here"
      }
    }
  }
}

Zed

Add to your settings (~/.config/zed/settings.json):

{
  "context_servers": {
    "testpad": {
      "command": "npx",
      "args": ["-y", "github:shapehq/mcp-testpad"],
      "env": {
        "TESTPAD_API_TOKEN": "your_token_here"
      }
    }
  }
}

Amazon Q Developer

Add to ~/.aws/amazonq/mcp.json:

{
  "mcpServers": {
    "testpad": {
      "command": "npx",
      "args": ["-y", "github:shapehq/mcp-testpad"],
      "env": {
        "TESTPAD_API_TOKEN": "your_token_here"
      }
    }
  }
}

Available Tools

Projects

Tool	Description
list_projects	List all active projects
get_project	Get a specific project by ID

Folders

Tool	Description
get_folders	Get all folders (nested tree) for a project
get_folder	Get a specific folder
create_folder	Create a root-level folder
create_subfolder	Create a folder inside another folder
modify_folder	Rename a folder

Scripts

Tool	Description
get_script	Get a script with its tests and runs
create_script	Create a script at project root
create_script_in_folder	Create a script inside a folder
modify_script	Update a script's name, description, or test items

Test Runs

Tool	Description
add_test_run	Submit test results for a script

Notes

Tool	Description
get_notes	Get notes (project or folder level)
create_note	Create a note
modify_note	Update an existing note

API Constraints

• No DELETE: Objects cannot be deleted via the API
• PATCH only: No PUT/wholesale replacement — only partial updates
• No tags via API: Tags cannot be created or modified through the public API — they can only be managed through the TestPad web UI
• Header fields: Cannot create new header field types via API (must be pre-defined in script)
• No retests: Cannot create retest runs through the API
• Archived projects: Not included in list responses

License

MIT