# Currents Mcp

> Currents MCP Server

- **Type:** MCP server
- **Install:** `agentstack add mcp-currents-dev-currents-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [currents-dev](https://agentstack.voostack.com/s/currents-dev)
- **Installs:** 0
- **Category:** [Web & Browser](https://agentstack.voostack.com/c/web-and-browser)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [currents-dev](https://github.com/currents-dev)
- **Source:** https://github.com/currents-dev/currents-mcp
- **Website:** https://currents.dev

## Install

```sh
agentstack add mcp-currents-dev-currents-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Currents MCP Server

Give your AI coding agents full visibility into your CI test results. The Currents MCP Server connects tools like Cursor and Claude directly to your [Currents](https://currents.dev) dashboard, so agents can diagnose flaky tests, pinpoint failures, and act on real execution data -- without leaving your editor.

- Query runs, spec files, and individual test results from CI
- Surface error trends and performance metrics across your test suite
- Manage quarantine rules, webhooks, and project settings programmatically
- Let agents fix what's broken using actual test output, not guesswork

[](https://cursor.com/en/install-mcp?name=currents&config=eyJjb21tYW5kIjoibnB4IC15IEBjdXJyZW50cy9tY3AiLCJlbnYiOnsiQ1VSUkVOVFNfQVBJX0tFWSI6InlvdXItYXBpLWtleSJ9fQ%3D%3D)

## Tools

| Tool                                    | Description                                                                               |
| --------------------------------------- | ----------------------------------------------------------------------------------------- |
| `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-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.                                                                         |

## Setup

### API Key

Get a Currents API key by following the [instructions here](https://docs.currents.dev/resources/api/api-keys).

### Usage with Cursor

1. Go to Cursor Settings > MCP > Enable
2. Add the following to your `mcp.json`.

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

### Claude

Run this command to add Currents MCP to Claude Code

```bash
claude mcp add --transport stdio currents --env CURRENTS_API_KEY= -- npx -y @currents/mcp
```

Add the following to enable Currents MCP on Claude Desktop (edit `claude_desktop_config.json` file):

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

### ⚠️ Notice

By connecting AI tools (e.g., via MCP) to Currents, you are granting them access to your API key, test results and CI metadata. It is your responsibility to vet any AI agents or services you use, and to ensure they handle your data securely.

## References

- [Currents](https://currents.dev)
- [Currents Documentation](https://docs.currents.dev)
- [Contribution Guide](https://github.com/currents-dev/currents-mcp/blob/main/CONTRIBUTE.md)
- [Releasing and Publishing](https://github.com/currents-dev/currents-mcp/blob/main/RELEASE.md)
- [License](https://github.com/currents-dev/currents-mcp/blob/main/LICENSE.md)

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [currents-dev](https://github.com/currents-dev)
- **Source:** [currents-dev/currents-mcp](https://github.com/currents-dev/currents-mcp)
- **License:** Apache-2.0
- **Homepage:** https://currents.dev

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-currents-dev-currents-mcp
- Seller: https://agentstack.voostack.com/s/currents-dev
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.
