{"id":27671526,"url":"https://github.com/currents-dev/currents-mcp","last_synced_at":"2026-05-19T03:23:29.393Z","repository":{"id":288449848,"uuid":"959421517","full_name":"currents-dev/currents-mcp","owner":"currents-dev","description":"Currents MCP Server","archived":false,"fork":false,"pushed_at":"2025-04-17T15:35:35.000Z","size":712,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-18T06:13:24.033Z","etag":null,"topics":["ai","currents","mcp","playwright"],"latest_commit_sha":null,"homepage":"https://currents.dev","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/currents-dev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-04-02T18:56:01.000Z","updated_at":"2025-04-17T15:35:39.000Z","dependencies_parsed_at":"2025-04-18T06:14:29.691Z","dependency_job_id":"fb6915f5-41bf-4864-acc1-db53ef6fdcb6","html_url":"https://github.com/currents-dev/currents-mcp","commit_stats":null,"previous_names":["currents-dev/currents-mcp"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/currents-dev%2Fcurrents-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/currents-dev%2Fcurrents-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/currents-dev%2Fcurrents-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/currents-dev%2Fcurrents-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/currents-dev","download_url":"https://codeload.github.com/currents-dev/currents-mcp/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250729110,"owners_count":21477606,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","currents","mcp","playwright"],"created_at":"2025-04-24T23:36:59.377Z","updated_at":"2026-05-19T03:23:29.386Z","avatar_url":"https://github.com/currents-dev.png","language":"TypeScript","funding_links":[],"categories":["Testing \u0026 Debugging Tools","پیاده‌سازی‌های سرور","💻 \u003ca name=\"development-tools\"\u003e\u003c/a\u003eDevelopment Tools","📦 Other","Official Servers","Developer Tools","Task and Project Management","カテゴリ","Web \u0026 Search","Server Implementations"],"sub_categories":["💻 \u003ca name=\"developer-tools\"\u003e\u003c/a\u003eابزارهای توسعه‌دهنده","How to Submit","🛠️ \u003ca name=\"developer-tools\"\u003e\u003c/a\u003e開発ツール","Testing \u0026 QA","💻 \u003ca name=\"developer-tools\"\u003e\u003c/a\u003eDeveloper Tools"],"readme":"# Currents MCP Server\n\n![Unit Tests](https://github.com/currents-dev/currents-mcp/actions/workflows/test.yml/badge.svg)\n\nThis 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.\n\n[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=currents\u0026config=eyJjb21tYW5kIjoibnB4IC15IEBjdXJyZW50cy9tY3AiLCJlbnYiOnsiQ1VSUkVOVFNfQVBJX0tFWSI6InlvdXItYXBpLWtleSJ9fQ%3D%3D)\n\n## Tools\n\n| Tool                                    | Description                                                                               |\n| --------------------------------------- | ----------------------------------------------------------------------------------------- |\n| `currents-list-actions`                 | List all actions for a project with optional filtering.                                   |\n| `currents-create-action`                | Create a new action for a project.                                                        |\n| `currents-get-action`                   | Get a single action by ID.                                                                |\n| `currents-update-action`                | Update an existing action.                                                                |\n| `currents-delete-action`                | Delete (archive) an action.                                                               |\n| `currents-enable-action`                | Enable a disabled action.                                                                 |\n| `currents-disable-action`               | Disable an active action.                                                                 |\n| `currents-list-affected-tests`          | List tests affected by actions (quarantine, skip, tag) for a project within a date range. |\n| `currents-get-affected-test-executions` | Get execution details for a specific affected test (by signature) within a date range.    |\n| `currents-get-affected-executions`      | List test executions where a specific action/rule was applied, within a date range.       |\n| `currents-get-projects`                 | Retrieves projects available in the Currents platform.                                    |\n| `currents-get-project`                  | Get a single project by ID.                                                               |\n| `currents-get-project-insights`         | Get aggregated run and test metrics for a project within a date range.                    |\n| `currents-get-runs`                     | Retrieves a list of runs for a specific project with optional filtering.                  |\n| `currents-get-run-details`              | Retrieves details of a specific test run.                                                 |\n| `currents-find-run`                     | Find a run by query parameters.                                                           |\n| `currents-cancel-run`                   | Cancel a run in progress.                                                                 |\n| `currents-reset-run`                    | Reset failed spec files in a run to allow re-execution.                                   |\n| `currents-delete-run`                   | Delete a run and all associated data.                                                     |\n| `currents-cancel-run-github-ci`         | Cancel a run by GitHub Actions workflow run ID and attempt number.                        |\n| `currents-get-spec-instance`            | Retrieves debugging data from a specific execution of a test spec file by instanceId.     |\n| `currents-get-spec-files-performance`   | Retrieves spec files performance metrics for a specific project within a date range.      |\n| `currents-get-tests-performance`        | Retrieves aggregated test metrics for a specific project within a date range.             |\n| `currents-get-tests-signatures`         | Generates a unique test signature based on project, spec file path, and test title.       |\n| `currents-get-test-results`             | Retrieves historical test execution results for a specific test signature.                |\n| `currents-get-errors-explorer`          | Get aggregated error metrics for a project within a date range.                           |\n| `currents-list-webhooks`                | List all webhooks for a project.                                                          |\n| `currents-create-webhook`               | Create a new webhook for a project.                                                       |\n| `currents-get-webhook`                  | Get a single webhook by ID.                                                               |\n| `currents-update-webhook`               | Update an existing webhook.                                                               |\n| `currents-delete-webhook`               | Delete a webhook.                                                                         |\n\n## Setup\n\n### API Key\n\nGet a Currents API key by following the [instructions here](https://docs.currents.dev/resources/api/api-keys).\n\n### Usage with Cursor\n\n1. Go to Cursor Settings \u003e MCP \u003e Enable\n2. Add the following to your `mcp.json`.\n\n```json\n{\n  \"mcpServers\": {\n    \"currents\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@currents/mcp\"],\n      \"env\": {\n        \"CURRENTS_API_KEY\": \"your-api-key\"\n      }\n    }\n  }\n}\n```\n\n### Claude\n\nRun this command to add Currents MCP to Claude Code\n\n```bash\nclaude mcp add --transport stdio currents --env CURRENTS_API_KEY=\u003cKEY\u003e -- npx -y @currents/mcp\n```\n\nAdd the following to enable Currents MCP on Claude Desktop (edit `claude_desktop_config.json` file):\n\n```json\n{\n  \"mcpServers\": {\n    \"currents\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@currents/mcp\"],\n      \"env\": {\n        \"CURRENTS_API_KEY\": \"your-api-key\"\n      }\n    }\n  }\n}\n```\n\n### ⚠️ Notice\n\nBy 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.\n\n## References\n\n- [Currents](https://currents.dev)\n- [Currents Documentation](https://docs.currents.dev)\n- [Contribution Guide](https://github.com/currents-dev/currents-mcp/blob/main/CONTRIBUTE.md)\n- [Releasing and Publishing](https://github.com/currents-dev/currents-mcp/blob/main/RELEASE.md)\n- [License](https://github.com/currents-dev/currents-mcp/blob/main/LICENSE.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcurrents-dev%2Fcurrents-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcurrents-dev%2Fcurrents-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcurrents-dev%2Fcurrents-mcp/lists"}