get_past_launches

Pack: launches · Endpoint: https://gateway.pipeworx.io/launches/mcp

Fetch rocket launches that have already flown, sorted newest-first, from Launch Library 2. launches holds only those with a confirmed outcome — successful, failed or partial failure — so counting them answers “how many launches happened”. A launch whose scheduled time has passed but whose outcome upstream has not yet confirmed is reported separately in unconfirmed with its current status, rather than being counted as flown. Use since and until to bound a window (ISO dates). Returns launch name, time, status, pad, rocket type, and mission description. Default 10 results.

Parameters

NameTypeRequiredDescription
sincestringnoOptional. Only launches at or after this time (ISO 8601, e.g. “2026-08-01” or “2026-08-01T00:00:00Z”). Use with until to count launches in a window.
untilstringnoOptional. Only launches before this time (ISO 8601). Defaults to now, since this tool covers launches that have already happened.
limitnumbernoNumber of launches to return (default 10)

Example call

Arguments

{
  "limit": 10
}

curl

curl -X POST https://gateway.pipeworx.io/launches/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_past_launches","arguments":{"limit":10}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('get_past_launches', {
  "limit": 10
});

More examples

{
  "limit": 20
}
{
  "since": "2026-07-30",
  "limit": 50
}

Response shape

Always returns: total, launches

FieldTypeDescription
totalnumberTotal count of past launches available
launchesarrayList of past launches
Full JSON Schema
{
  "type": "object",
  "properties": {
    "total": {
      "type": "number",
      "description": "Total count of past launches available"
    },
    "launches": {
      "type": "array",
      "description": "List of past launches",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Launch Library 2 launch UUID"
          },
          "name": {
            "type": "string",
            "description": "Launch name"
          },
          "net": {
            "type": [
              "string",
              "null"
            ],
            "description": "Actual launch date/time (ISO 8601)"
          },
          "status": {
            "type": [
              "string",
              "null"
            ],
            "description": "Launch status name"
          },
          "status_description": {
            "type": [
              "string",
              "null"
            ],
            "description": "Detailed status description"
          },
          "pad_name": {
            "type": [
              "string",
              "null"
            ],
            "description": "Launch pad name"
          },
          "location": {
            "type": [
              "string",
              "null"
            ],
            "description": "Launch location/facility name"
          },
          "location_country": {
            "type": [
              "string",
              "null"
            ],
            "description": "Launch location country code"
          },
          "rocket_name": {
            "type": [
              "string",
              "null"
            ],
            "description": "Rocket full name or configuration name"
          },
          "mission_name": {
            "type": [
              "string",
              "null"
            ],
            "description": "Mission name"
          },
          "mission_description": {
            "type": [
              "string",
              "null"
            ],
            "description": "Mission objectives and details"
          },
          "mission_type": {
            "type": [
              "string",
              "null"
            ],
            "description": "Mission type classification"
          }
        },
        "required": [
          "id",
          "name"
        ]
      }
    }
  },
  "required": [
    "total",
    "launches"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "launches": {
      "url": "https://gateway.pipeworx.io/launches/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

Regenerated from source · build August 8, 2026