# TestAtlas MCP server

> Query a .NET test-automation solution as a map: search steps and scenarios, check reuse, trace impact, and list endpoints.

- Listing: https://mcp.tc/i/testatlas
- Connect: this is a local (stdio) server; install it on your machine (see Install). The listing link is a page, not an MCP endpoint.
- Type: local (stdio)
- Auth: no API key needed
- Category: [Developer Tools](https://mcp.tc/c/developer-tools)
- Vendor: Karzone
- Repository: <https://github.com/Karzone/TestAtlas>
- Package: nuget `TestAtlas.Mcp`

## About

TestAtlas indexes a .NET test-automation solution into a single SQLite file and serves it to an AI agent. The map covers Gherkin features, scenarios and steps, step definitions and their bindings, page objects, API clients, project dependencies and endpoints. An agent can check whether a step already exists, search steps and scenarios, and see which scenarios a change affects.

It runs locally over stdio as the NuGet package TestAtlas.Mcp, using the .NET SDK (8.0+; dnx needs .NET 10). First build the map with the TestAtlas.Cli tool (testatlas index), then pass the codemap.db path to the server. Analysis is offline and deterministic, with no network calls and no API key.

## What it can do

- Check whether a step phrase already binds to an existing definition
- Browse the reusable step vocabulary with placeholders
- Find scenarios affected by changing a class, method, step or endpoint
- Full-text search over step definitions and scenarios
- Fetch a scenario or step definition in detail
- List tags, endpoints and project dependencies
- Show entity counts and binding coverage

## Example prompts

- "Does a step for adding a product to the cart already exist?"
- "Which scenarios are affected if I change the CatalogApiClient?"
- "Search the scenarios for login and show the first match."
- "List all API endpoints called by the test projects."

## Install

### Claude Code

1. Run this in a terminal, in your project folder:

```bash
claude mcp add --transport stdio testatlas -- dnx TestAtlas.Mcp --yes
```

2. Start Claude Code and type `/mcp`. **testatlas** should show as connected.

Add `--scope user` to make it available in every project.

### Claude Desktop

1. Open **Settings → Developer → Edit Config**. It opens `claude_desktop_config.json`. Add:

`claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "testatlas": {
      "command": "dnx",
      "args": [
        "TestAtlas.Mcp",
        "--yes"
      ]
    }
  }
}
```

2. Save the file and restart Claude Desktop.

Needs .NET 10 on your computer. The file lives in `~/Library/Application Support/Claude/` on macOS and `%APPDATA%\Claude\` on Windows.

### Cursor

[Add to Cursor](<https://cursor.com/install-mcp?name=testatlas&config=eyJjb21tYW5kIjoiZG54IiwiYXJncyI6WyJUZXN0QXRsYXMuTWNwIiwiLS15ZXMiXX0%3D>) (opens Cursor)

Or add it by hand to `~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` (this project):

`mcp.json`:

```json
{
  "mcpServers": {
    "testatlas": {
      "command": "dnx",
      "args": [
        "TestAtlas.Mcp",
        "--yes"
      ]
    }
  }
}
```

Needs .NET 10 on your computer.

### VS Code

[Install in VS Code](<https://vscode.dev/redirect/mcp/install?name=testatlas&config=%7B%22type%22%3A%22stdio%22%2C%22command%22%3A%22dnx%22%2C%22args%22%3A%5B%22TestAtlas.Mcp%22%2C%22--yes%22%5D%7D>) (opens VS Code)

Or from a terminal:

```bash
code --add-mcp '{"name":"testatlas","type":"stdio","command":"dnx","args":["TestAtlas.Mcp","--yes"]}'
```

Or commit it to the repo in `.vscode/mcp.json`:

`.vscode/mcp.json`:

```json
{
  "servers": {
    "testatlas": {
      "type": "stdio",
      "command": "dnx",
      "args": [
        "TestAtlas.Mcp",
        "--yes"
      ]
    }
  }
}
```

Needs .NET 10 on your computer.

### Devin Desktop

1. Add it to `~/.config/devin/mcp_config.json` (macOS and Linux) or `%APPDATA%\devin\mcp_config.json` (Windows):

`mcp_config.json`:

```json
{
  "mcpServers": {
    "testatlas": {
      "command": "dnx",
      "args": [
        "TestAtlas.Mcp",
        "--yes"
      ]
    }
  }
}
```

2. Refresh the MCP server list in Cascade.

Devin Desktop is the new name for Windsurf.

### Codex

```bash
codex mcp add testatlas -- dnx TestAtlas.Mcp --yes
```

Or edit `~/.codex/config.toml` directly:

`config.toml`:

```toml
[mcp_servers.testatlas]
command = "dnx"
args = ["TestAtlas.Mcp", "--yes"]
```

Needs .NET 10 on your computer.

### Gemini CLI

```bash
gemini mcp add testatlas dnx -- TestAtlas.Mcp --yes
```

This adds it to the current project. Add `-s user` to use it everywhere.

### Any client

Most clients that start local servers accept this shape:

```json
{
  "mcpServers": {
    "testatlas": {
      "command": "dnx",
      "args": [
        "TestAtlas.Mcp",
        "--yes"
      ]
    }
  }
}
```

Zed puts servers under `context_servers` in its settings, with the same `command`, `args` and `env` fields.

Needs .NET 10 on your computer.

## Details

- Server version: 0.1.13
- Last checked: 2026-10-05
- Listed: 2026-10-05
- Updated: 2026-10-05

---
Source: https://mcp.tc/i/testatlas (mcp.tc is an independent directory, not affiliated with this server's publisher). Corrections: https://mcp.tc/report