`get_planet`

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

Get a Star Wars planet by its numeric ID. Returns name, climate, terrain, population, and orbital data.

Parameters

Name	Type	Required	Description
`id`	number	yes	Planet ID (e.g., 1 for Tatooine)

Example call

Arguments

{
  "id": 1
}

curl

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

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('get_planet', {
  "id": 1
});

More examples

{
  "id": 8
}

Response shape

Always returns: name, rotation_period, orbital_period, diameter, climate, gravity, terrain, surface_water, population, url

Field	Type	Description
`name`	string	Planet name
`rotation_period`	string	Rotation period
`orbital_period`	string	Orbital period
`diameter`	string	Diameter
`climate`	string	Climate
`gravity`	string	Gravity
`terrain`	string	Terrain
`surface_water`	string	Surface water percentage
`population`	string	Population
`url`	string	Planet URL

Full JSON Schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Planet name"
    },
    "rotation_period": {
      "type": "string",
      "description": "Rotation period"
    },
    "orbital_period": {
      "type": "string",
      "description": "Orbital period"
    },
    "diameter": {
      "type": "string",
      "description": "Diameter"
    },
    "climate": {
      "type": "string",
      "description": "Climate"
    },
    "gravity": {
      "type": "string",
      "description": "Gravity"
    },
    "terrain": {
      "type": "string",
      "description": "Terrain"
    },
    "surface_water": {
      "type": "string",
      "description": "Surface water percentage"
    },
    "population": {
      "type": "string",
      "description": "Population"
    },
    "url": {
      "type": "string",
      "description": "Planet URL"
    }
  },
  "required": [
    "name",
    "rotation_period",
    "orbital_period",
    "diameter",
    "climate",
    "gravity",
    "terrain",
    "surface_water",
    "population",
    "url"
  ]
}

Connect

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

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

See Getting Started for client-specific install steps.

get_planet