Skip to main content
Glama

Create a mission

create_mission

Create the tracker issue AND start the run in one call, for work that has no issue yet. Pass entryStartAt='builder' with an entryPlan to hand over a plan you already wrote; pass entryStartAt='reviewer'/'qa' with entryPrNumber to hand over an existing build — in which case title may be omitted and the pull request's own title names the mission. For the first mission of a SHIP Sites project, pass starter (website, blog, docs or waitlist) and site, the shared form, in place of title and description: SHIP writes the issue, or a mission with no issue on a project SHIP made with Start from scratch, and holds the site address. Read list_site_starters first. This tool calls the SHIP API, documented at https://letsship.ai/docs/api. Requires the missions:run token scope.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "projectId": "<projectId>"
    },
    "name": "create_mission"
  }
}

Input Schema

NameRequiredDescriptionDefault
siteNoThe form of a site starter. Required with starter; leave out title, description, labels and entry
titleNoIssue title. Omit ONLY with entryPrNumber — the pull request's own title is then used
agentsNoPer-role harness/model override for THIS mission only; overrides ship.yml without changing it
labelsNoTracker labels to apply
starterNoThe first mission of a SHIP Sites project of this kind; needs site
entryPlanNoHand-off plan markdown, for entryStartAt='builder'
projectIdYesProject id the mission belongs to
descriptionNoIssue body; acceptance criteria written here are parsed as they would be on any issue
entryStartAtNoPipeline stage to enter at; omit for the default full run starting at the planner
entryPrNumberNoExisting open PR number, required for entryStartAt='reviewer' or 'qa'

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed17 schema fields changed
    • changedInput schema / properties / site / properties / business / description
      Previous value: -"website: the optional answers of a type of business. list_site_starters gives each type and its questions. Send only the answers the person gave: the starter site leaves out a section with no answer"New value: +"website: the optional answers of a type of business. list_site_starters gives each type and its questions. Send only the answers the type asks, and only those the person gave: the starter site leaves out a section with no answer"
    • changedInput schema / properties / site / properties / business / properties / address / description
      Previous value: -"local-business: the street, the postcode and the town"New value: +"local-business, restaurant, appointments, events: the street, the postcode and the town"
    • addedInput schema / properties / site / properties / business / properties / appStoreUrl
      Added value: +{
      +  "description": "app: an https URL of the app on the App Store",
      +  "type": "string"
      +}
    • changedInput schema / properties / site / properties / business / properties / bookingUrl / description
      Previous value: -"local-business: an https URL where customers book"New value: +"local-business, restaurant, appointments, coach: an https URL where customers book"
    • addedInput schema / properties / site / properties / business / properties / email
      Added value: +{
      +  "description": "portfolio: the email address where people ask for work",
      +  "type": "string"
      +}
    • addedInput schema / properties / site / properties / business / properties / events
      Added value: +{
      +  "description": "events: one to twelve dates, each YYYY-MM-DD, the time, then the name, the place and the price, such as 2026-11-21 20:30 Jazz night, The Cellar, €18",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / site / properties / business / properties / googlePlayUrl
      Added value: +{
      +  "description": "app: an https URL of the app on Google Play",
      +  "type": "string"
      +}
    • changedInput schema / properties / site / properties / business / properties / hours / description
      Previous value: -"local-business: one to seven groups of days, each the days then the hours, such as Monday to Friday 08:00 to 18:00 or Sunday: closed"New value: +"local-business, restaurant, appointments: one to seven groups of days, each the days then the hours, such as Monday to Friday 08:00 to 18:00 or Sunday: closed"
    • addedInput schema / properties / site / properties / business / properties / menu
      Added value: +{
      +  "description": "restaurant: one to twelve dishes, each the name then the price with its currency, such as Tomato soup €7",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / site / properties / business / properties / orderUrl
      Added value: +{
      +  "description": "restaurant: an https URL where guests order to take away or for delivery",
      +  "type": "string"
      +}
    • changedInput schema / properties / site / properties / business / properties / phone / description
      Previous value: -"local-business: the phone number customers call"New value: +"local-business, restaurant, appointments: the phone number customers call"
    • addedInput schema / properties / site / properties / business / properties / products
      Added value: +{
      +  "description": "shop: one to eight products, each the name then the price with its currency, such as Stoneware mug €24",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / site / properties / business / properties / services
      Added value: +{
      +  "description": "appointments, coach: one to ten services, each the name, the time if given, then the price with its currency, such as Haircut 30 min €25",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / site / properties / business / properties / shopUrl
      Added value: +{
      +  "description": "shop: an https URL where people buy",
      +  "type": "string"
      +}
    • addedInput schema / properties / site / properties / business / properties / ticketsUrl
      Added value: +{
      +  "description": "events: an https URL where people buy tickets",
      +  "type": "string"
      +}
    • changedInput schema / properties / site / properties / business / properties / type / enum
      Previous value: -[
      -  "local-business"
      -]New value: +[
      +  "local-business",
      +  "restaurant",
      +  "appointments",
      +  "coach",
      +  "app",
      +  "portfolio",
      +  "shop",
      +  "events"
      +]
    • addedInput schema / properties / site / properties / business / properties / work
      Added value: +{
      +  "description": "portfolio: one to six kinds of work, one for each line, such as Posters",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
  2. Changed9 schema fields changed
    • addedInput schema / properties / site / properties / about
      Added value: +{
      +  "description": "website, blog and waitlist: the three answers every founder gives first. Ask the person all three. The other facts of the kind are optional",
      +  "properties": {
      +    "description": {
      +      "description": "What the business does and for whom, in the person's words: 10 to 2000 characters",
      +      "type": "string"
      +    },
      +    "location": {
      +      "description": "Where the business is, in the person's words: a town, an address, or online",
      +      "type": "string"
      +    },
      +    "name": {
      +      "description": "The name of the business, 2 to 60 characters",
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "name",
      +    "location",
      +    "description"
      +  ],
      +  "type": "object"
      +}
    • removedInput schema / properties / site / properties / audience
      Removed value: -{
      -  "description": "website and waitlist: the main audience",
      -  "type": "string"
      -}
    • changedInput schema / properties / site / properties / author / description
      Previous value: -"blog: the author of the first post"New value: +"blog, optional: the author of the first post. Without it, the business"
    • changedInput schema / properties / site / properties / brand / properties / brandName / description
      Previous value: -"2 to 60 characters, for the sources logo and preset"New value: +"2 to 60 characters, for the sources logo and preset. With about, send about.name"
    • addedInput schema / properties / site / properties / business
      Added value: +{
      +  "description": "website: the optional answers of a type of business. list_site_starters gives each type and its questions. Send only the answers the person gave: the starter site leaves out a section with no answer",
      +  "properties": {
      +    "address": {
      +      "description": "local-business: the street, the postcode and the town",
      +      "type": "string"
      +    },
      +    "bookingUrl": {
      +      "description": "local-business: an https URL where customers book",
      +      "type": "string"
      +    },
      +    "hours": {
      +      "description": "local-business: one to seven groups of days, each the days then the hours, such as Monday to Friday 08:00 to 18:00 or Sunday: closed",
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "phone": {
      +      "description": "local-business: the phone number customers call",
      +      "type": "string"
      +    },
      +    "prices": {
      +      "description": "local-business: one to eight prices, each the name then the price with its currency, such as Brake service €25",
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "type": {
      +      "description": "A type from businessTypes of list_site_starters",
      +      "enum": [
      +        "local-business"
      +      ],
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "type"
      +  ],
      +  "type": "object"
      +}
    • addedInput schema / properties / site / properties / language
      Added value: +{
      +  "description": "The language of the site's words, from languages of list_site_starters. Without it, English",
      +  "enum": [
      +    "en",
      +    "de",
      +    "fr",
      +    "es",
      +    "nl",
      +    "pt",
      +    "tr"
      +  ],
      +  "type": "string"
      +}
    • removedInput schema / properties / site / properties / offerings
      Removed value: -{
      -  "description": "website: one to three products or services",
      -  "items": {
      -    "type": "string"
      -  },
      -  "type": "array"
      -}
    • changedInput schema / properties / site / properties / product / description
      Previous value: -"waitlist: what people join the waitlist for. Only a project SHIP made with Start from scratch takes it"New value: +"waitlist, optional: what people join the waitlist for. Without it, the business. Only a project SHIP made with Start from scratch takes a waitlist"
    • changedInput schema / properties / site / properties / topic / description
      Previous value: -"blog: the topic of the first post"New value: +"blog, optional: the topic of the first post. Without it, the business"
  3. Changed2 schema fields changed
    • addedInput schema / properties / site
      Added value: +{
      +  "description": "The form of a site starter. Required with starter; leave out title, description, labels and entry",
      +  "properties": {
      +    "audience": {
      +      "description": "website and waitlist: the main audience",
      +      "type": "string"
      +    },
      +    "author": {
      +      "description": "blog: the author of the first post",
      +      "type": "string"
      +    },
      +    "brand": {
      +      "description": "Where the brand comes from (one of three sources)",
      +      "properties": {
      +        "brandName": {
      +          "description": "2 to 60 characters, for the sources logo and preset",
      +          "type": "string"
      +        },
      +        "logo": {
      +          "description": "The logo file, for the brand source logo",
      +          "properties": {
      +            "contentType": {
      +              "enum": [
      +                "image/png",
      +                "image/jpeg",
      +                "image/webp"
      +              ],
      +              "type": "string"
      +            },
      +            "data": {
      +              "description": "The file, base64-encoded, up to 2 MB",
      +              "minLength": 1,
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "contentType",
      +            "data"
      +          ],
      +          "type": "object"
      +        },
      +        "presetId": {
      +          "description": "A preset id from list_brand_presets, for the source preset",
      +          "type": "string"
      +        },
      +        "source": {
      +          "description": "website: SHIP captures the brand from websiteUrl. logo: from logo. preset: one of list_brand_presets",
      +          "enum": [
      +            "website",
      +            "logo",
      +            "preset"
      +          ],
      +          "type": "string"
      +        },
      +        "websiteUrl": {
      +          "description": "An https URL that answers, for the source website",
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "source"
      +      ],
      +      "type": "object"
      +    },
      +    "brandRights": {
      +      "description": "The confirmation of the person the token acts for: they own this brand or have the right to use it. Send it only when that person confirmed the text that list_site_starters gives.",
      +      "properties": {
      +        "accepted": {
      +          "const": true,
      +          "type": "boolean"
      +        },
      +        "textVersion": {
      +          "description": "brandRights.version from list_site_starters",
      +          "minLength": 1,
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "accepted",
      +        "textVersion"
      +      ],
      +      "type": "object"
      +    },
      +    "kind": {
      +      "description": "The same kind as starter",
      +      "enum": [
      +        "website",
      +        "blog",
      +        "docs",
      +        "waitlist"
      +      ],
      +      "type": "string"
      +    },
      +    "offerings": {
      +      "description": "website: one to three products or services",
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "outline": {
      +      "description": "docs: three to seven page titles",
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "product": {
      +      "description": "waitlist: what people join the waitlist for. Only a project SHIP made with Start from scratch takes it",
      +      "type": "string"
      +    },
      +    "productName": {
      +      "description": "docs: the product name",
      +      "type": "string"
      +    },
      +    "productWebsite": {
      +      "description": "docs: the product website, an https URL",
      +      "type": "string"
      +    },
      +    "slug": {
      +      "description": "The site address: https://<slug>.letsship.app, 3 to 40 of a-z, 0-9 and hyphens",
      +      "minLength": 1,
      +      "type": "string"
      +    },
      +    "topic": {
      +      "description": "blog: the topic of the first post",
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "kind",
      +    "slug",
      +    "brand",
      +    "brandRights"
      +  ],
      +  "type": "object"
      +}
    • addedInput schema / properties / starter
      Added value: +{
      +  "description": "The first mission of a SHIP Sites project of this kind; needs site",
      +  "enum": [
      +    "website",
      +    "blog",
      +    "docs",
      +    "waitlist"
      +  ],
      +  "type": "string"
      +}
  4. First observed

TDQS

A4.5/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare non-read-only, open-world and non-idempotent, and the description goes further by disclosing the external SHIP API dependency, the required missions:run token scope, and downstream side effects (SHIP writes the issue, captures a brand from websiteUrl, holds the site address). It does not warn about duplicate missions on retry despite idempotentHint=false, which keeps it below a 5.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The primary action is front-loaded and the conditional paths follow in a logical order; nearly every clause carries a distinct rule. Some sentences are overloaded and slightly tangled ('SHIP writes the issue, or a mission with no issue on a project SHIP made with Start from scratch, and holds the site address'), which costs it the top score.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 10-parameter tool with nested objects and no output schema, the description covers the branching entry modes, the starter pathway and the auth scope, which is most of what is needed to call it correctly. It never indicates what comes back (mission id? issue URL?), leaving one gap given the absence of an output schema.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3, but the description adds real cross-parameter semantics the schema cannot express: which parameters pair with which entryStartAt value, that title may be dropped only with entryPrNumber, and that starter+site displaces title, description, labels and entry. That conditional coupling is the genuinely useful layer here.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The opening sentence states a specific verb and a compound effect — 'Create the tracker issue AND start the run in one call' — and immediately scopes it to 'work that has no issue yet', which separates it from the start_mission / create_scheduled_task style siblings. An agent can tell what it produces without opening the schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It lays out concrete routing: entryStartAt='builder' requires entryPlan, reviewer/qa requires entryPrNumber (and permits omitting title), and starter+site replaces title/description for the first mission of a SHIP Sites project. It also names a prerequisite action, 'Read list_site_starters first', so the agent knows the ordering constraint before calling.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.