Star Wars

liveEntertainmentFilm/TV

Explore Star Wars universe data — characters, planets, starships, and films from SWAPI

4tools
0msauth
free tier50 calls/day

Tools

search_peoplerequired: query

Search Star Wars characters by name. Returns name, physical attributes, birth year, gender, and homeworld URL.

Parameters
NameTypeDescription
queryreqstringCharacter name to search for (e.g., "Luke")
▶Try it
get_planetrequired: id

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

Parameters
NameTypeDescription
idreqnumberPlanet ID (e.g., 1 for Tatooine)
▶Try it
get_starshiprequired: id

Get a Star Wars starship by its numeric ID. Returns name, model, manufacturer, crew capacity, and hyperdrive rating.

Parameters
NameTypeDescription
idreqnumberStarship ID (e.g., 9 for the Death Star)
▶Try it
get_filmrequired: id

Get a Star Wars film by its numeric ID. Returns title, episode number, director, producer, release date, and opening crawl.

Parameters
NameTypeDescription
idreqnumberFilm ID (e.g., 1 for A New Hope)
▶Try it

Test with curl

The gateway speaks JSON-RPC 2.0 over HTTP POST. You can test any pack directly from the terminal.

List available tools
bash
curl -X POST https://gateway.pipeworx.io/swapi/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Call a tool
bash
curl -X POST https://gateway.pipeworx.io/swapi/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search_people","arguments":{"query": "hello"}}}'

Use with the SDK

Install @pipeworx/sdk to call tools from any TypeScript/Node project.

TypeScript
import { Pipeworx } from '@pipeworx/sdk';
const px = new Pipeworx();
const result = await px.call("search_people", {"query":"example"});
ask_pipeworx
// Or ask in plain English:
const answer = await px.ask("explore star wars universe data — characters, planets, starships, and films from swapi");