Star Wars

live Entertainment

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

4 tools
0ms auth
free tier 50 calls/day

Tools

search_people required: query

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

Parameters
Name Type Description
query req string Character name to search for (e.g., "Luke")
▶ Try it
get_planet required: id

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

Parameters
Name Type Description
id req number Planet ID (e.g., 1 for Tatooine)
▶ Try it
get_starship required: id

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

Parameters
Name Type Description
id req number Starship ID (e.g., 9 for the Death Star)
▶ Try it
get_film required: id

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

Parameters
Name Type Description
id req number Film 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");