AI & Machine Learning
letsship.ai
MCP server exposing SHIP workspace management tools for identity/RBAC, setup progress, billing credits and ledger, and API health.
ENDPOINT 1
https://mcp.letsship.ai/mcp
MCP server metadata
- Name
- ai.letsship/ship
- Version
- 0.24.4
SHIP runs a team of AI coding agents (planner, builder, reviewer, QA) on the user's own GitHub repository. Each mission takes one issue to a pull request that passed CI, a code review and a test of its acceptance criteria. Start with whoami (who you act as, the workspace and the token's scopes) or list_projects (the project ids that mission calls need). Mission lifecycle: - start_mission runs an issue that already exists in the tracker; create_mission files the issue and starts it in one call. - A mission runs for tens of minutes. To wait on one of its agent runs, call watch_agent_run, not a poll: it returns when the run ends or its stage changes. Read get_mission between runs. inspect_mission has the full record when one fails. - To change what a mission does, or to answer its review, call send_mission_instruction. Never call start_mission again to send feedback: call it again only to restart a mission that ended or needs attention. Credits: start_mission, create_mission and run_scheduled_task each start a mission, and every started mission spends workspace credits. Read get_billing before you start work for someone. Instructions to a mission that is already open are free. Handles are stable: an issue id (SHIP-123, WEB-42) and a project id name the same mission and project across calls and conversations. Keep them instead of searching again. A refusal that names a missing scope means this token cannot do that action. Ask the person to grant the scope; do not retry.
Known tools 71
whoamiReturns the caller's identity, org, role, role-derived RBAC capabilities, and token scopes.
Inferred read-onlyget_setup_progressRead what the workspace has set up with SHIP so far, as the console's setup checklist shows it: up to 13 milestones in three groups, taken in order (get started, make it yours, make it autonomous).
Inferred read-onlyget_billingRead the workspace's credit balance by source and expiry, whether a new mission would start now, the per-mission credit ceiling, the project allowance and recent usage.
Inferred read-onlylist_billing_ledgerList where the workspace's credits went, newest first: one entry per mission (its start, each further 3 agent-hours, and messages charged before messages became free), per grant, per adjustment and per expiry.
Inferred read-onlylist_credit_offersList what SHIP sells: the credit packs (credits, the tax-inclusive price in US dollars and the price per credit), the monthly plans under `team.
Inferred read-onlyupdate_team_subscriptionChange the workspace's monthly plan subscription: plan switches between starter and scale from the next renewal on (nothing is charged or refunded for the current month; passing the current plan drops a waiting switch), or cancelAtPeriodEnd true ends it when the month already paid for ends, false resumes it before then.
Inferred read-onlyrequest_more_creditsAsk for more credits for the workspace, saying what they are for.
Inferred read-onlyget_noticesRead what needs attention in the workspace, critical first: a tracker connection its vendor no longer accepts (missions cannot start or report back until someone reconnects it), or credits running out.
Inferred read-onlydismiss_noticeClose a notice for the person this token acts for, as the console's close button does.
Inferred read-onlyupdate_projectChange the settings of one project; a field you leave out keeps its value.
Inferred read-onlycreate_missionCreate the tracker issue AND start the run in one call, for work that has no issue yet.
Potential side effectsset_agents_overridePatch one role's harness/model/effort/prompt for a single mission, layered over ship.
Inferred read-onlyget_agents_overrideRead the per-issue agents/baseBranch override record for one mission, or null when unset.
Inferred read-onlyclear_agents_overrideDelete the per-issue agents/baseBranch override — the mission resolves from ship.
Potential side effectslist_missionsList missions in the caller's accessible projects, newest activity first, with total for paging.
Inferred read-onlystop_missionHard-stop a mission: every agent run of it stops and its work in progress is lost.
Inferred read-onlyapprove_mission_ceilingA mission that reached its credit limit pauses until a member lets it continue.
Inferred read-onlymerge_missionMerge the mission's open pull request on GitHub with the repository's own merge method; the mission then becomes done, and the merge cannot be undone from here.
Inferred read-onlydecline_missionClose the mission's open pull request on GitHub without merging it; the mission becomes declined, and no call here reopens it.
Inferred read-onlyset_mission_auto_mergeSet whether SHIP merges this mission's pull request by itself once the checks, the review and the test pass.
Inferred read-onlyunarchive_missionShow an archived mission in list_missions and on the board again.
Inferred read-onlyset_mission_dispositionRecord a person's reason for how a mission ended, which the delivery statistics use: product (real work, judged on its merits), probe (a test on purpose), superseded (another mission replaced it: give supersededBy) or takeover (a person finished the work outside SHIP); null clears it.
Inferred read-onlylist_scheduled_tasksList recurring agent missions (scheduled tasks) across the caller's accessible projects — schedule, enabled state, and next/last fire time for each.
Inferred read-onlylist_scheduled_task_templatesRead-only gallery of curated scheduled task templates — a prepared prompt plus a suggested cadence.
Inferred read-onlyget_scheduled_taskFetch one scheduled task by id: its project, name, prompt, triggers (schedule), labels, template key, skip-if-previous-open setting, enabled state, and next/last run times.
Inferred read-onlyupdate_scheduled_taskPatch a scheduled task's name, prompt, schedule, skip-guard, or enabled state — only the fields passed are changed.
Inferred read-onlyrun_scheduled_taskFire a scheduled task immediately, bypassing both its schedule and the skip-if-previous-open guard — an explicit run always creates a new issue even while a prior fire's mission is still open.
Inferred read-onlylist_scheduled_task_runsRun history for one scheduled task, each row's status (dispatching/dispatched/skipped/failed) and, once its issue exists, the joined mission progress/cost.
Inferred read-onlydelete_scheduled_taskDelete a scheduled task and its run history, which no call can bring back.
Potential side effectslist_mcp_serversThe MCP servers a project's repository declares in its MCP file (.
Inferred read-onlylist_mcp_bindingsEvery MCP server binding across the projects you can see in your org: project, server, transport, status, enabled roles, how it authenticates, and the NAMES of the credential fields set (never values).
Inferred read-onlyset_mcp_config_pathPoint the project at the repository file that declares its MCP servers, e.
Inferred read-onlybind_mcp_serverCreate or update the binding for a server the repository declares.
Potential side effectsunbind_mcp_serverDelete a binding and its stored credential: no role receives the server from its next run.
Potential side effectsrefresh_mcp_server_toolsSnapshot the bound server's current tools (with their readOnlyHint / destructiveHint annotations) for approval.
Inferred read-onlylist_agent_runsList the agent runs, live and finished, in the caller's accessible projects, newest first.
Inferred read-onlyget_agent_runFetch one agent run: its run record, metric series (CPU/mem/disk over time), and the agent session summaries (role, outcome, cost, sessionId).
Inferred read-onlywatch_agent_runWait on one agent run and follow what its agent does, instead of polling get_agent_run.
Inferred read-onlylist_sandbox_templatesList the org's sandboxes (definitions agents start in), with each one's active version, size and latest build status.
Inferred read-onlyget_sandbox_capacityHow many agents the org's missions are running at once against its limit (null while the org is unclassified), which missions wait for an agent slot and why, and whether every slot on the platform is taken.
Inferred read-onlylist_sandbox_startersReady-made sandbox definitions (Python, Java, Go, Rust, Ruby) to create a sandbox from.
Potential side effectslist_sandbox_template_versionsEvery saved version of a sandbox, newest first, with the active one marked and each one's latest build.
Inferred read-onlyactivate_sandbox_template_versionMake a version the one missions use from their next dispatch.
Inferred read-onlybuild_sandbox_templateBuild the sandbox's active version, or return the build already running for it.
Inferred read-onlylist_sandbox_registriesThe org's private package registries sandboxes install from: host, auth scheme, username.
Inferred read-onlydelete_sandbox_registryDelete the stored credential of a private registry (an id from list_sandbox_registries).
Potential side effectslist_environmentsList per-mission preview environments for the caller's accessible projects.
Inferred read-onlyget_environmentFetch one preview environment's registry row (status, worker name, timestamps).
Inferred read-onlydestroy_environmentRequest teardown of a preview environment (its deployed Worker(s) + every provisioned datastore).
Inferred read-onlylist_artifactsList proof-of-work artifacts (QA screenshots/video/traces) for the caller's accessible projects.
Inferred read-onlyget_artifactFetch one artifact's metadata + a long-lived signed serving url (open it to view the screenshot/video).
Inferred read-onlyinspect_missionFetch the typed platform-inspection report for a mission, by its issue id.
Inferred read-onlylist_orgsList every organization on the platform with its owner email, member count, and pending invite status.
Potential side effectsCONNECT WITH APPROVAL
Client installation
Review this server and its permissions before adding it. Secret placeholders must be set locally.
Codex
~/.codex/config.toml
[mcp_servers.ai-letsship-ship]
url = "https://mcp.letsship.ai/mcp"
enabled = true
Claude Code
.mcp.json
{
"mcpServers": {
"ai-letsship-ship": {
"type": "http",
"url": "https://mcp.letsship.ai/mcp"
}
}
}
Claude Desktop
Settings → Connectors → Add custom connector
Name: ai-letsship-ship
Remote MCP URL: https://mcp.letsship.ai/mcp
Add this remote URL as a custom connector in Claude Desktop. Availability depends on the user plan and workspace policy.
Cursor
.cursor/mcp.json
{
"mcpServers": {
"ai-letsship-ship": {
"url": "https://mcp.letsship.ai/mcp"
}
}
}
Visual Studio Code
.vscode/mcp.json
Add to Visual Studio Code{
"servers": {
"ai-letsship-ship": {
"type": "http",
"url": "https://mcp.letsship.ai/mcp"
}
}
}
Generic MCP
Client-specific MCP configuration
{
"name": "ai-letsship-ship",
"transport": "streamable-http",
"url": "https://mcp.letsship.ai/mcp"
}
MCP Inspector
Run the official MCP Inspector locally and enter the indexed Streamable HTTP endpoint.
TRUST AND VERIFICATION EVIDENCE
Loading Trust v2 evidence…
Checking the associated registrable domain. The BuiltWith key remains server-side.
Evidence is source-attributed and does not guarantee that a third-party server is safe. Risk labels are conservative metadata heuristics.