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
| Name | Type | Required | Description |
|---|---|---|---|
since | string | no | Optional. 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. |
until | string | no | Optional. Only launches before this time (ISO 8601). Defaults to now, since this tool covers launches that have already happened. |
limit | number | no | Number 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
| Field | Type | Description |
|---|---|---|
total | number | Total count of past launches available |
launches | array | List 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.