What is Currents?

Currents is an MCP (MCP Server) that allows AI agents to access test results data from Playwright test failures reported to Currents. It provides context about test failures and CI metadata to help AI agents fix or optimize tests.

How to use Currents?

1. Installation: Install the Currents MCP server via Smithery or manually via NPX.
2. API Key Setup: Obtain a Currents API key from Currents documentation.
3. Configuration: Add the Currents configuration to your mcp.json or claude_desktop_config.json with your API key.
4. Usage with Cursor/Claude: Enable MCP in the respective editor settings and connect AI agents to Currents.

Key Features of Currents?

• API Configuration: Fetch API key and URL for Currents API requests.
• Run Information: Retrieve run details by its ID.
• Test Results Insights: Access spec file attempts and errors for debugging.
• Cross-Editor Support: Works with Cursor Editor and Claude Desktop.

Use Cases of Currents?

1. Debugging Test Failures: AI agents analyze Playwright test failures and propose fixes.
2. CI Optimization: Improve continuous integration pipelines based on test data.
3. Test Automation: Automate test corrections and optimizations.

FAQ from Currents?

• How do I get a Currents API key?

Follow the instructions at Currents Documentation.

• Is Currents free to use?

Not explicitly stated, but requires an API key for access.

• What editors support Currents?

Cursor Editor and Claude Desktop are supported.

Currents MCP Server

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.

Tools

1. get-api-config

• Get the API key and URL used to make requests to Currents API

2. get-run

• Get the run information by its ID

3. get-spec-file-attempts-and-errors

• Get the instance information about attempts and errors by its ID

Setup

API Key

Get a Currents API key by following the instructions here.

Usage with Cursor Editor

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

NPX

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

Usage with Claude Desktop

Installing via Smithery

To install Currents Test Results Context Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @currents-dev/currents-mcp --client claude

Add the following to your claude_desktop_config.json:

NPX

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