# currents-dev/currents-mcp [Health: Active]

**Category:** 📂 Browser Automation  
**Repository:** https://github.com/currents-dev/currents-mcp  
**GitHub Stars:** 20  
**npm Downloads (last month):** 147424  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/currents-dev-currents-mcp

## Description
Enable AI Agents to fix Playwright test failures reported to Currents.

## Tools
Capabilities this server exposes over MCP:

- **currents-list-actions** — List all actions for a project with optional filtering.
- **currents-create-action** — Create a new action for a project.
- **currents-get-action** — Get a single action by ID.
- **currents-update-action** — Update an existing action.
- **currents-delete-action** — Delete (archive) an action.
- **currents-enable-action** — Enable a disabled action.
- **currents-disable-action** — Disable an active action.
- **currents-list-affected-tests** — List tests affected by actions (quarantine, skip, tag) for a project within a date range.
- **currents-get-affected-test-executions** — Get execution details for a specific affected test (by signature) within a date range.
- **currents-get-affected-executions** — List test executions where a specific action/rule was applied, within a date range.
- **currents-get-projects** — Retrieves projects available in the Currents platform.
- **currents-get-project** — Get a single project by ID.
- **currents-get-project-insights** — Get aggregated run and test metrics for a project within a date range.
- **currents-list-pull-requests** — List pull-request cards for a project (runs grouped by meta.pr.id).
- **currents-list-project-terms** — List cursor-paginated project terms for one type (tag, branch, authorName, etc.).
- **currents-create-jira-issue** — Create a Jira issue from a run test using the organization Jira integration.
- **currents-link-jira-issue** — Link an existing Jira issue to a run test using the organization Jira integration.
- **currents-list-jira-projects** — List Jira projects available for the organization integration.
- **currents-list-jira-issue-types** — List Jira issue types and custom fields for a Jira project.
- **currents-get-runs** — Retrieves a list of runs for a specific project with optional filtering.
- **currents-get-run-details** — Retrieves details of a specific test run.
- **currents-find-run** — Find a run by query parameters.
- **currents-cancel-run** — Cancel a run in progress.
- **currents-reset-run** — Reset failed spec files in a run to allow re-execution.
- **currents-delete-run** — Delete a run and all associated data.
- **currents-cancel-run-github-ci** — Cancel a run by GitHub Actions workflow run ID and attempt number.
- **currents-get-spec-instance** — Retrieves debugging data from a specific execution of a test spec file by instanceId.
- **currents-get-spec-files-performance** — Retrieves spec files performance metrics for a specific project within a date range.
- **currents-get-tests-performance** — Retrieves aggregated test metrics for a specific project within a date range.
- **currents-get-tests-signatures** — Generates a unique test signature based on project, spec file path, and test title.
- **currents-get-test-results** — Retrieves historical test execution results for a specific test signature.
- **currents-get-context** — Get test failure context for AI debugging at run, instance, or test level.
- **currents-get-errors-explorer** — Get aggregated error metrics for a project within a date range.
- **currents-get-test-evidence** — Collect evidence artifacts (screenshots, videos, traces, attachments) produced by tests in a CI run, with signed download URLs grouped per test.
- **currents-list-webhooks** — List all webhooks for a project.
- **currents-create-webhook** — Create a new webhook for a project.
- **currents-get-webhook** — Get a single webhook by ID.
- **currents-update-webhook** — Update an existing webhook.
- **currents-delete-webhook** — Delete a webhook.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

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

**Requires environment variables:** `CURRENTS_API_KEY` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What currents-dev/currents-mcp MCP server does

The currents-dev/currents-mcp MCP server exposes Currents dashboard and CI test data to MCP-compatible coding agents. It is aimed at diagnosing Playwright test failures using recorded execution data rather than inferred results. Agents can inspect runs, spec instances, test results, failure context, error aggregates, historical performance, and test evidence such as screenshots, videos, traces, and attachments.

The server also supports operational workflows around Currents projects. Agents can create, update, enable, disable, and archive actions such as quarantine, skip, or tag rules. They can manage project webhooks, inspect pull-request cards, retrieve project terms, and create or link Jira issues through the organization’s Jira integration.

## How it works

MCP clients invoke named Currents tools, with each tool handling a focused query or mutation. Read operations cover projects, runs, individual executions, test signatures, affected tests, errors, performance, and evidence. Date-range and filtering options are available for several project and execution queries.

Run operations include finding runs, retrieving run details, cancelling an in-progress run, resetting failed spec files for re-execution, deleting runs, and cancelling a run through a GitHub Actions workflow run ID and attempt number. Test debugging can be narrowed to a run, instance, or test level through failure-context retrieval.

Jira operations use the organization’s existing Jira integration. The available tools can list Jira projects and issue types, create an issue from a run test, or link an existing issue to one. Evidence retrieval returns signed download URLs grouped by test, according to the README.

## Setup and configuration

Install currents-dev/currents-mcp MCP server with the project’s documented command:

```bash
npx -y @currents/mcp
```

Configure the `CURRENTS_API_KEY` environment variable with a Currents API key. The repository’s Cursor installation configuration passes this variable to the server. The supplied material does not document additional environment variables, authentication scopes, or account setup steps.

The README identifies Cursor and Claude as supported agent integrations. It does not provide client-specific configuration details beyond the Cursor installation link and environment-variable example.

## Tools and capabilities

The documented tool groups include:

- Actions: list, create, retrieve, update, archive, enable, and disable project actions.
- Affected tests: inspect tests and executions influenced by actions within a date range.
- Projects and analytics: list projects, retrieve a project, inspect insights, terms, error metrics, spec-file performance, and test performance.
- Runs and debugging: query runs, inspect details, find runs, cancel or reset runs, delete runs, inspect spec instances, retrieve historical test results, and get failure context.
- Collaboration: list pull-request cards and create or link Jira issues.
- Artifacts and automation: retrieve test evidence, manage webhooks, and cancel GitHub Actions CI runs.
- Test identity: generate signatures from a project, spec-file path, and test title.

## Limitations and notes

The currents-dev/currents-mcp MCP server depends on access to Currents data and a configured API key. The provided material does not state whether Currents accounts or particular features require payment. It also does not document permissions, rate limits, retention, webhook payloads, or the exact schemas for tool arguments and responses.

Actions that change or remove data include updating, disabling, archiving, cancelling, resetting, deleting, and creating resources. Review agent permissions before enabling these operations in an automated workflow. Jira tools likewise depend on an organization Jira integration being available.

_Full upstream README: https://allmcps.com/mcp/currents-dev-currents-mcp/readme_