`search_people`

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

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/search_people for the schema, then POST the same URL with its arguments for the data.

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

Parameters

Name	Type	Required	Description
`query`	string	yes	Character name to search for (e.g., “Luke”)

Example call

Arguments

{
  "query": "Luke"
}

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":"search_people","arguments":{"query":"Luke"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('search_people', {
  "query": "Luke"
});

More examples

{
  "query": "Darth Vader"
}

Response shape

Always returns: count, results

Field	Type	Description
`count`	number	Total count of matching characters
`results`	array	List of matching characters

Full JSON Schema

{
  "type": "object",
  "properties": {
    "count": {
      "type": "number",
      "description": "Total count of matching characters"
    },
    "results": {
      "type": "array",
      "description": "List of matching characters",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "Character name"
          },
          "height": {
            "type": "string",
            "description": "Height"
          },
          "mass": {
            "type": "string",
            "description": "Mass"
          },
          "hair_color": {
            "type": "string",
            "description": "Hair color"
          },
          "skin_color": {
            "type": "string",
            "description": "Skin color"
          },
          "eye_color": {
            "type": "string",
            "description": "Eye color"
          },
          "birth_year": {
            "type": "string",
            "description": "Birth year"
          },
          "gender": {
            "type": "string",
            "description": "Gender"
          },
          "homeworld": {
            "type": "string",
            "description": "Homeworld URL"
          },
          "url": {
            "type": "string",
            "description": "Character URL"
          }
        },
        "required": [
          "name",
          "height",
          "mass",
          "hair_color",
          "skin_color",
          "eye_color",
          "birth_year",
          "gender",
          "homeworld",
          "url"
        ]
      }
    }
  },
  "required": [
    "count",
    "results"
  ]
}

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.

search_people