SHIP

{
  "name": "SHIP",
  "description": "SHIP's team of AI coding agents turns a task description, a tracker issue or an open pull request into a pull request with proof it works. The agents plan, build, review and test the change in the customer's own repository. Each A2A task is one SHIP mission, and a mission runs for minutes to hours. So send each message with configuration.returnImmediately set to true, then poll GetTask. Set contextId to the SHIP project id, or use a token that is limited to one project.",
  "supportedInterfaces": [
    {
      "url": "https://mcp.letsship.ai/a2a",
      "protocolBinding": "JSONRPC",
      "protocolVersion": "1.0"
    }
  ],
  "provider": {
    "organization": "SHIP",
    "url": "https://letsship.ai"
  },
  "version": "1.1.0",
  "documentationUrl": "https://letsship.ai/docs/a2a",
  "iconUrl": "https://letsship.ai/icon.png",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "extendedAgentCard": false
  },
  "securitySchemes": {
    "shipOAuth": {
      "oauth2SecurityScheme": {
        "description": "Sign in with OAuth: authorization code with PKCE. Send resource set to this agent's endpoint URL (RFC 8707) at the authorization and token requests, because a token for another SHIP resource does not work here. A person approves the request in the SHIP console. Add offline_access to get a refresh token.",
        "flows": {
          "authorizationCode": {
            "authorizationUrl": "https://letsship.ai/oauth/authorize",
            "tokenUrl": "https://api.letsship.ai/v1/oauth2/token",
            "refreshUrl": "https://api.letsship.ai/v1/oauth2/token",
            "scopes": {
              "missions:read": "Read tasks: their state, pull request and proof.",
              "missions:run": "Start tasks. Each task is a SHIP mission and uses credits.",
              "missions:write": "Send instructions to a task, and cancel it.",
              "artifacts:read": "Read the proof that a task produced, such as test traces and screenshots.",
              "offline_access": "Get a refresh token, so access continues after the one-hour access token expires."
            },
            "pkceRequired": true
          }
        },
        "oauth2MetadataUrl": "https://letsship.ai/.well-known/oauth-authorization-server"
      }
    },
    "shipToken": {
      "httpAuthSecurityScheme": {
        "scheme": "Bearer",
        "description": "A SHIP personal access token (pat_) in the Authorization header. A person creates it in the SHIP console, and its scopes limit what this agent can do. See https://letsship.ai/auth.md."
      }
    }
  },
  "securityRequirements": [
    {
      "schemes": {
        "shipOAuth": {
          "list": [
            "missions:read",
            "missions:run",
            "missions:write",
            "artifacts:read"
          ]
        }
      }
    },
    {
      "schemes": {
        "shipToken": {
          "list": []
        }
      }
    }
  ],
  "defaultInputModes": [
    "text/plain"
  ],
  "defaultOutputModes": [
    "text/plain",
    "text/markdown",
    "application/json"
  ],
  "skills": [
    {
      "id": "create-mission",
      "name": "Turn a task into a pull request",
      "description": "Creates a mission from a task description. SHIP opens an issue in the project's tracker. Then its agents plan, build, review and test the change in the project's repository and open a pull request. The first line of the message is the issue title, and the full text is the issue body. Needs the missions:run scope.",
      "tags": [
        "coding",
        "pull-request",
        "code-review",
        "testing"
      ],
      "examples": [
        "Add a rate limit of 60 requests a minute to the public search endpoint.\nReturn 429 with a Retry-After header when a client goes over the limit.",
        "Fix the date picker so that it keeps the selected date when the user changes the month."
      ]
    },
    {
      "id": "start-issue",
      "name": "Hand over an existing issue",
      "description": "Starts a mission for an issue that is already in the project's tracker. Put the issue id in the message metadata as issueId, for example SHIP-412. Needs the missions:run scope.",
      "tags": [
        "issue",
        "tracker",
        "delegation"
      ],
      "examples": [
        "Start the issue in the metadata. Metadata: {\"issueId\": \"SHIP-412\"}"
      ]
    },
    {
      "id": "review-pull-request",
      "name": "Review and test a pull request",
      "description": "Gives an open pull request to SHIP's reviewer, or to its QA agent, with no planning or building stage first. Set metadata.startAt to reviewer or qa, and metadata.prNumber to the pull request number. The mission takes the title of the pull request, and the message text becomes the issue body. Needs the missions:run scope.",
      "tags": [
        "code-review",
        "testing",
        "pull-request"
      ],
      "examples": [
        "Review and test pull request 128. Metadata: {\"startAt\": \"reviewer\", \"prNumber\": 128}"
      ]
    },
    {
      "id": "send-instruction",
      "name": "Send a change request to a task",
      "description": "Send a message with the taskId of an open task. By default the message asks the builder to change the open pull request. Set metadata.kind to note to record context for the next agent without a new run. Needs the missions:write scope.",
      "tags": [
        "feedback",
        "change-request"
      ],
      "examples": [
        "Keep the current Node compatibility. Override nopt instead of narrowing the supported range."
      ]
    },
    {
      "id": "track-task",
      "name": "Report the status and results of a task",
      "description": "GetTask returns the state of a task, its pull request, the plan, the review and acceptance-test verdicts and the proof that QA captured. ListTasks lists the tasks of a project, newest update first. Needs the missions:read scope, and artifacts:read for the proof.",
      "tags": [
        "status",
        "verdict",
        "artifacts"
      ],
      "examples": [
        "What is the state of my last task, and did its tests pass?"
      ]
    },
    {
      "id": "stop-task",
      "name": "Stop a task",
      "description": "CancelTask stops the mission. SHIP stops its agents, and the pull request stays open. Needs the missions:write scope.",
      "tags": [
        "control"
      ],
      "examples": [
        "Stop the task."
      ]
    }
  ]
}