# cucumberstudio

Connect an AI assistant to Cucumber Studio projects, test scenarios, reusable steps, and run data. Useful when you want to inspect testing information through MCP.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 22
- Author: HeroSizy
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/HeroSizy/cucumberstudio-mcp
- Updated: 2026-03-28
- HTML: https://affpapa.org/en/nevibecode/mcp/cucumberstudio

## What it does

The server gives an assistant access to Cucumber Studio data. It can list projects, browse scenarios or search them by tag, retrieve reusable step definitions, and show test runs, executions, and build information. It provides test data access; it does not run the tests.

Choose STDIO or HTTP transport. You can launch it with `npx cucumberstudio-mcp`, but it needs `CUCUMBERSTUDIO_ACCESS_TOKEN`, `CUCUMBERSTUDIO_CLIENT_ID`, and `CUCUMBERSTUDIO_UID` to connect to the Cucumber Studio API. Without those credentials, the server cannot access the account data. `MCP_TRANSPORT` selects the transport; its default is `stdio`.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add cucumberstudio -- npx -y cucumberstudio-mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add cucumberstudio -- npx -y cucumberstudio-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "cucumberstudio": {
            "command": "npx",
            "args": [
                "-y",
                "cucumberstudio-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "cucumberstudio": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "cucumberstudio-mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add cucumberstudio npx -y cucumberstudio-mcp
```

## When to use it
- retrieve Cucumber Studio project details
- search test scenarios by tag
- look up reusable step definitions
- inspect test runs and executions
- check build information

## Example prompts
- Find Cucumber Studio scenarios tagged `smoke`.
- List my Cucumber Studio projects and show details for the relevant project.
- Show recent test runs and their build information.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [Front-End Checklist](https://affpapa.org/en/nevibecode/mcp/front-end-checklist.md) — MCP server · ★ 74559
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89433

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md