SpaceX REST API — Rockets

naftiko: 1.0.0-alpha2
info:
  label: SpaceX REST API — Rockets
  description: 'SpaceX rocket-version capability. List and inspect Falcon 1, Falcon 9, Falcon Heavy, and Starship records. Lead operation: List rockets.'
  tags:
    - SpaceX
    - Rockets
    - Falcon 9
    - Falcon Heavy
    - Starship
  created: '2026-05-29'
  modified: '2026-05-29'
binds: []
capability:
  consumes:
    - type: http
      namespace: spacex-rockets
      baseUri: https://api.spacexdata.com
      description: SpaceX rocket-version capability against the community REST API.
      resources:
        - name: rockets
          path: /v4/rockets
          operations:
            - name: listRockets
              method: GET
              description: List all rocket versions.
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: array
                  value: $.
        - name: rockets-id
          path: /v4/rockets/{id}
          operations:
            - name: getRocket
              method: GET
              description: Get one rocket by ID.
              outputRawFormat: json
              inputParameters:
                - name: id
                  in: path
                  type: string
                  required: true
              outputParameters:
                - name: result
                  type: object
                  value: $.
  exposes:
    - type: mcp
      namespace: spacex-rockets-mcp
      port: 9090
      transport: http
      description: MCP adapter for SpaceX rockets.
      tools:
        - name: list-rockets
          description: List all SpaceX rocket versions.
          hints: { readOnly: true, destructive: false, idempotent: true }
          call: spacex-rockets.listRockets
          outputParameters:
            - type: array
              mapping: $.
        - name: get-rocket
          description: Get a single SpaceX rocket version by ID.
          hints: { readOnly: true, destructive: false, idempotent: true }
          call: spacex-rockets.getRocket
          with: { id: tools.id }
          outputParameters:
            - type: object
              mapping: $.