Currents

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

GitHub

Currents MCP Server

Unit Tests

This is a MCP server that allows you to provide test results context to your AI agents by connecting them to Currents. Useful for asking AI to fix or optimize tests failing in CI.

Install MCP Server

Tools

ToolDescription
currents-get-projectsRetrieves projects available in the Currents platform.
currents-get-projectGet a single project by ID.
currents-get-project-insightsGet aggregated run and test metrics for a project within a date range.
currents-get-runsRetrieves a list of runs for a specific project with optional filtering.
currents-get-run-detailsRetrieves details of a specific test run.
currents-find-runFind a run by query parameters.
currents-cancel-runCancel a run in progress.
currents-reset-runReset failed spec files in a run to allow re-execution.
currents-delete-runDelete a run and all associated data.
currents-cancel-run-github-ciCancel a run by GitHub Actions workflow run ID and attempt number.
currents-get-spec-instanceRetrieves debugging data from a specific execution of a test spec file by instanceId.
currents-get-spec-files-performanceRetrieves spec files performance metrics for a specific project within a date range.
currents-get-tests-performanceRetrieves aggregated test metrics for a specific project within a date range.
currents-get-tests-signaturesGenerates a unique test signature based on project, spec file path, and test title.
currents-get-test-resultsRetrieves historical test execution results for a specific test signature.
currents-list-actionsList all actions for a project with optional filtering.
currents-create-actionCreate a new action for a project.
currents-get-actionGet a single action by ID.
currents-update-actionUpdate an existing action.
currents-delete-actionDelete (archive) an action.
currents-enable-actionEnable a disabled action.
currents-disable-actionDisable an active action.
currents-list-webhooksList all webhooks for a project.
currents-create-webhookCreate a new webhook for a project.
currents-get-webhookGet a single webhook by ID.
currents-update-webhookUpdate an existing webhook.
currents-delete-webhookDelete a webhook.

Setup

API Key

Get a Currents API key by following the instructions here.

Usage with Cursor

  1. Go to Cursor Settings > MCP > Enable
  2. Add the following to your mcp.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

claude mcp add --transport stdio currents --env CURRENTS_API_KEY=<KEY> -- npx -y @currents/mcp

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

{
  "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

Related Servers