API Evangelist MCP binding overlay for Currents REST API

overlay: 1.0.0
info:
  title: API Evangelist MCP binding overlay for Currents REST API
  version: 1.0.0
extends: ../openapi/_original/currents-dev-openapi.yml
x-generated: '2026-11-04'
x-method: derived
x-source: mcp/currents-dev-tool-crosswalk.yml (https://docs.currents.dev/ai/reference/mcp-server.md)
x-rationale: Annotates each REST operation backed by a documented Currents MCP tool with x-mcp-tool (tool name, hosted server,
  required permission, binding confidence). The original spec is not mutated.
actions:
- target: $.paths['/projects'].get
  description: Bind listProjects to the documented Currents MCP tool currents-get-projects.
  update:
    x-mcp-tool:
      name: currents-get-projects
      server: https://mcp.currents.dev/mcp
      permission: projects:read
      confidence: high
- target: $.paths['/projects/{projectId}'].get
  description: Bind getProject to the documented Currents MCP tool currents-get-project.
  update:
    x-mcp-tool:
      name: currents-get-project
      server: https://mcp.currents.dev/mcp
      permission: projects:read
      confidence: high
- target: $.paths['/projects/{projectId}/terms/{termType}'].get
  description: Bind listProjectTermsByType to the documented Currents MCP tool currents-list-project-terms.
  update:
    x-mcp-tool:
      name: currents-list-project-terms
      server: https://mcp.currents.dev/mcp
      permission: projects:read
      confidence: high
- target: $.paths['/projects/{projectId}/runs'].get
  description: Bind listProjectRuns to the documented Currents MCP tool currents-get-runs.
  update:
    x-mcp-tool:
      name: currents-get-runs
      server: https://mcp.currents.dev/mcp
      permission: results:read
      confidence: high
- target: $.paths['/runs/{runId}'].get
  description: Bind getRun to the documented Currents MCP tool currents-get-run-details.
  update:
    x-mcp-tool:
      name: currents-get-run-details
      server: https://mcp.currents.dev/mcp
      permission: results:read
      confidence: high
- target: $.paths['/runs/find'].get
  description: Bind findRun to the documented Currents MCP tool currents-find-run.
  update:
    x-mcp-tool:
      name: currents-find-run
      server: https://mcp.currents.dev/mcp
      permission: results:read
      confidence: high
- target: $.paths['/instances/{instanceId}'].get
  description: Bind getInstance to the documented Currents MCP tool currents-get-spec-instance.
  update:
    x-mcp-tool:
      name: currents-get-spec-instance
      server: https://mcp.currents.dev/mcp
      permission: results:read
      confidence: high
- target: $.paths['/test-results/{signature}'].get
  description: Bind getTestResults to the documented Currents MCP tool currents-get-test-results.
  update:
    x-mcp-tool:
      name: currents-get-test-results
      server: https://mcp.currents.dev/mcp
      permission: results:read
      confidence: high
- target: $.paths['/context'].get
  description: Bind getContext to the documented Currents MCP tool currents-get-context.
  update:
    x-mcp-tool:
      name: currents-get-context
      server: https://mcp.currents.dev/mcp
      permission: results:read
      confidence: high
- target: $.paths['/projects/{projectId}/pull-requests'].get
  description: Bind listProjectPullRequests to the documented Currents MCP tool currents-list-pull-requests.
  update:
    x-mcp-tool:
      name: currents-list-pull-requests
      server: https://mcp.currents.dev/mcp
      permission: results:read
      confidence: high
- target: $.paths['/projects/{projectId}/insights'].get
  description: Bind getProjectInsights to the documented Currents MCP tool currents-get-project-insights.
  update:
    x-mcp-tool:
      name: currents-get-project-insights
      server: https://mcp.currents.dev/mcp
      permission: analytics:read
      confidence: high
- target: $.paths['/spec-files/{projectId}/metrics'].get
  description: Bind getSpecFilesMetrics to the documented Currents MCP tool currents-get-spec-files-performance.
  update:
    x-mcp-tool:
      name: currents-get-spec-files-performance
      server: https://mcp.currents.dev/mcp
      permission: analytics:read
      confidence: medium
- target: $.paths['/tests/{projectId}/metrics'].get
  description: Bind getTestsMetrics to the documented Currents MCP tool currents-get-tests-performance.
  update:
    x-mcp-tool:
      name: currents-get-tests-performance
      server: https://mcp.currents.dev/mcp
      permission: analytics:read
      confidence: medium
- target: $.paths['/errors/{projectId}'].get
  description: Bind getErrorsExplorer to the documented Currents MCP tool currents-get-errors-explorer.
  update:
    x-mcp-tool:
      name: currents-get-errors-explorer
      server: https://mcp.currents.dev/mcp
      permission: analytics:read
      confidence: high
- target: $.paths['/actions'].get
  description: Bind listActions to the documented Currents MCP tool currents-list-actions.
  update:
    x-mcp-tool:
      name: currents-list-actions
      server: https://mcp.currents.dev/mcp
      permission: actions:read
      confidence: high
- target: $.paths['/actions/{actionId}'].get
  description: Bind getAction to the documented Currents MCP tool currents-get-action.
  update:
    x-mcp-tool:
      name: currents-get-action
      server: https://mcp.currents.dev/mcp
      permission: actions:read
      confidence: high
- target: $.paths['/actions/tests'].get
  description: Bind listAffectedTests to the documented Currents MCP tool currents-list-affected-tests.
  update:
    x-mcp-tool:
      name: currents-list-affected-tests
      server: https://mcp.currents.dev/mcp
      permission: actions:read
      confidence: high
- target: $.paths['/actions/tests/{signature}'].get
  description: Bind getAffectedTestExecutions to the documented Currents MCP tool currents-get-affected-test-executions.
  update:
    x-mcp-tool:
      name: currents-get-affected-test-executions
      server: https://mcp.currents.dev/mcp
      permission: actions:read
      confidence: high
- target: $.paths['/actions/{actionId}/tests'].get
  description: Bind getAffectedTestExecutionsByAction to the documented Currents MCP tool currents-get-action-executions.
  update:
    x-mcp-tool:
      name: currents-get-action-executions
      server: https://mcp.currents.dev/mcp
      permission: actions:read
      confidence: high
- target: $.paths['/actions'].post
  description: Bind createAction to the documented Currents MCP tool currents-create-action.
  update:
    x-mcp-tool:
      name: currents-create-action
      server: https://mcp.currents.dev/mcp
      permission: actions:write
      confidence: high
- target: $.paths['/actions/{actionId}'].put
  description: Bind updateAction to the documented Currents MCP tool currents-update-action.
  update:
    x-mcp-tool:
      name: currents-update-action
      server: https://mcp.currents.dev/mcp
      permission: actions:write
      confidence: high
- target: $.paths['/actions/{actionId}'].delete
  description: Bind deleteAction to the documented Currents MCP tool currents-delete-action.
  update:
    x-mcp-tool:
      name: currents-delete-action
      server: https://mcp.currents.dev/mcp
      permission: actions:write
      confidence: high
- target: $.paths['/actions/{actionId}/enable'].put
  description: Bind enableAction to the documented Currents MCP tool currents-enable-action.
  update:
    x-mcp-tool:
      name: currents-enable-action
      server: https://mcp.currents.dev/mcp
      permission: actions:write
      confidence: high
- target: $.paths['/actions/{actionId}/disable'].put
  description: Bind disableAction to the documented Currents MCP tool currents-disable-action.
  update:
    x-mcp-tool:
      name: currents-disable-action
      server: https://mcp.currents.dev/mcp
      permission: actions:write
      confidence: high
- target: $.paths['/sessions'].post
  description: Bind createSession to the documented Currents MCP tool currents-create-session.
  update:
    x-mcp-tool:
      name: currents-create-session
      server: https://mcp.currents.dev/mcp
      permission: runs:write
      confidence: high
- target: $.paths['/sessions/{sessionId}/attachments'].post
  description: Bind addSessionAttachments to the documented Currents MCP tool currents-add-attachments.
  update:
    x-mcp-tool:
      name: currents-add-attachments
      server: https://mcp.currents.dev/mcp
      permission: runs:write
      confidence: medium
- target: $.paths['/runs/{runId}/attachments'].post
  description: Bind attachRunAttachments to the documented Currents MCP tool currents-add-attachments.
  update:
    x-mcp-tool:
      name: currents-add-attachments
      server: https://mcp.currents.dev/mcp
      permission: runs:write
      confidence: medium
- target: $.paths['/runs/{runId}/cancel'].put
  description: Bind cancelRun to the documented Currents MCP tool currents-cancel-run.
  update:
    x-mcp-tool:
      name: currents-cancel-run
      server: https://mcp.currents.dev/mcp
      permission: runs:write
      confidence: high
- target: $.paths['/runs/cancel-ci/github'].put
  description: Bind cancelRunByGithubCI to the documented Currents MCP tool currents-cancel-run-github-ci.
  update:
    x-mcp-tool:
      name: currents-cancel-run-github-ci
      server: https://mcp.currents.dev/mcp
      permission: runs:write
      confidence: high
- target: $.paths['/runs/{runId}/reset'].put
  description: Bind resetRun to the documented Currents MCP tool currents-reset-run.
  update:
    x-mcp-tool:
      name: currents-reset-run
      server: https://mcp.currents.dev/mcp
      permission: runs:write
      confidence: high
- target: $.paths['/runs/{runId}'].delete
  description: Bind deleteRun to the documented Currents MCP tool currents-delete-run.
  update:
    x-mcp-tool:
      name: currents-delete-run
      server: https://mcp.currents.dev/mcp
      permission: runs:write
      confidence: high
- target: $.paths['/share'].post
  description: Bind createShareLink to the documented Currents MCP tool currents-create-share-link.
  update:
    x-mcp-tool:
      name: currents-create-share-link
      server: https://mcp.currents.dev/mcp
      permission: shares:write
      confidence: high
- target: $.paths['/webhooks'].get
  description: Bind listWebhooks to the documented Currents MCP tool currents-list-webhooks.
  update:
    x-mcp-tool:
      name: currents-list-webhooks
      server: https://mcp.currents.dev/mcp
      permission: webhooks:read
      confidence: high
- target: $.paths['/webhooks/{hookId}'].get
  description: Bind getWebhook to the documented Currents MCP tool currents-get-webhook.
  update:
    x-mcp-tool:
      name: currents-get-webhook
      server: https://mcp.currents.dev/mcp
      permission: webhooks:read
      confidence: high
- target: $.paths['/webhooks'].post
  description: Bind createWebhook to the documented Currents MCP tool currents-create-webhook.
  update:
    x-mcp-tool:
      name: currents-create-webhook
      server: https://mcp.currents.dev/mcp
      permission: webhooks:write
      confidence: high
- target: $.paths['/webhooks/{hookId}'].put
  description: Bind updateWebhook to the documented Currents MCP tool currents-update-webhook.
  update:
    x-mcp-tool:
      name: currents-update-webhook
      server: https://mcp.currents.dev/mcp
      permission: webhooks:write
      confidence: high
- target: $.paths['/webhooks/{hookId}'].delete
  description: Bind deleteWebhook to the documented Currents MCP tool currents-delete-webhook.
  update:
    x-mcp-tool:
      name: currents-delete-webhook
      server: https://mcp.currents.dev/mcp
      permission: webhooks:write
      confidence: high
- target: $.paths['/integrations/jira/projects'].get
  description: Bind listJiraProjects to the documented Currents MCP tool currents-list-jira-projects.
  update:
    x-mcp-tool:
      name: currents-list-jira-projects
      server: https://mcp.currents.dev/mcp
      permission: issues:write
      confidence: high
- target: $.paths['/integrations/jira/projects/{jiraProjectId}/issue-types'].get
  description: Bind listJiraIssueTypes to the documented Currents MCP tool currents-list-jira-issue-types.
  update:
    x-mcp-tool:
      name: currents-list-jira-issue-types
      server: https://mcp.currents.dev/mcp
      permission: issues:write
      confidence: high
- target: $.paths['/projects/{projectId}/jira/issues'].post
  description: Bind createJiraIssueFromRunTest to the documented Currents MCP tool currents-create-jira-issue.
  update:
    x-mcp-tool:
      name: currents-create-jira-issue
      server: https://mcp.currents.dev/mcp
      permission: issues:write
      confidence: high
- target: $.paths['/projects/{projectId}/jira/issues/{jiraIssueKey}/link'].post
  description: Bind linkJiraIssueFromRunTest to the documented Currents MCP tool currents-link-jira-issue.
  update:
    x-mcp-tool:
      name: currents-link-jira-issue
      server: https://mcp.currents.dev/mcp
      permission: issues:write
      confidence: high
- target: $.paths['/signature/test'].post
  description: Bind getTestSignature to the documented Currents MCP tool currents-get-tests-signatures.
  update:
    x-mcp-tool:
      name: currents-get-tests-signatures
      server: https://mcp.currents.dev/mcp
      permission: Every connection
      confidence: high