# Currents MCP server

> Lets AI coding agents query CI test runs, spec files, and test results from the Currents dashboard to diagnose failures and flaky tests.

- Repository: https://github.com/currents-dev/currents-mcp
- Page: https://hostedmcp.org/servers/currents-dev/currents-mcp
- Transport: stdio, remote
- Stars: 21
- License: Apache-2.0
- Latest version: 1.0.0

## Install

### Claude Code

```sh
claude mcp add currents-mcp -- npx -y @currents/mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "currents-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@currents/mcp"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "currents-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@currents/mcp"
      ]
    }
  }
}
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "currents-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@currents/mcp"
      ]
    }
  }
}
```

### Codex (`~/.codex/config.toml`)

```toml
[mcp_servers.currents-mcp]
command = "npx"
args = ["-y", "@currents/mcp"]
```

### Gemini CLI (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "currents-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@currents/mcp"
      ]
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `CURRENTS_API_KEY` | no | no |  |

## Tools (43)

- `currents-list-actions`
- `currents-create-action`
- `currents-get-action`
- `currents-update-action`
- `currents-delete-action`
- `currents-enable-action`
- `currents-disable-action`
- `currents-list-affected-tests`
- `currents-get-affected-test-executions`
- `currents-get-action-executions`
- `currents-get-projects`
- `currents-get-project`
- `currents-get-project-insights`
- `currents-list-pull-requests`
- `currents-list-project-terms`
- `currents-create-jira-issue`
- `currents-link-jira-issue`
- `currents-list-jira-projects`
- `currents-list-jira-issue-types`
- `currents-get-runs`
- `currents-get-run-details`
- `currents-find-run`
- `currents-cancel-run`
- `currents-reset-run`
- `currents-delete-run`
- `currents-cancel-run-github-ci`
- `currents-get-spec-instance`
- `currents-get-spec-files-performance`
- `currents-get-tests-performance`
- `currents-get-tests-signatures`
- `currents-get-test-results`
- `currents-get-context`
- `currents-get-errors-explorer`
- `currents-get-test-evidence`
- `currents-create-evidence-links`
- `currents-create-session`
- `currents-add-attachments`
- `currents-list-webhooks`
- `currents-create-share-link`
- `currents-create-webhook`
- `currents-get-webhook`
- `currents-update-webhook`
- `currents-delete-webhook`

## FAQ

### What does the Currents MCP server let AI agents do?

It connects coding agents to the Currents dashboard so they can query runs, spec files, and test results, surface error trends, and manage quarantine rules and project settings.

### Can agents create or link Jira issues through this server?

Yes, the server includes tools to create a Jira issue from a run test, link an existing Jira issue, and list Jira projects and issue types.

### Can I manage quarantine and skip rules with this MCP server?

Yes, tools let agents list, create, update, delete, enable, and disable actions such as quarantine, skip, and tag rules for a project.

### Does it support Cursor and Claude?

The Currents MCP Server is designed to connect tools like Cursor and Claude to your Currents dashboard.