MCP Server

Star Wars MCP

build.swapi/star-wars
Media & Content Public & reachable MCP 2025-11-25

What this MCP does

Provides searchable access to Star Wars films, characters, planets, species, starships, and vehicles.

sw_get
Gets one Star Wars entity by numeric id. Ids are the record ids from each entity's url field (e.g. FILMS id 1 = A New Hope). Returns a JSON object.
Read only Idempotent
Input schema
{'type': 'object', 'required': ['resource', 'id'], 'properties': {'id': {'type': 'integer', 'description': "Numeric record id (from the entity's url field)"}, 'resource': {'enum': ['PEOPLE', 'FILMS', 'PLANETS', 'SPECIES', 'STARSHIPS', 'VEHICLES'], 'type': 'string', 'description': 'Resource type'}}}
sw_list
Lists all entities of a Star Wars resource type from swapi.build. Returns a JSON array.
Read only Idempotent
Input schema
{'type': 'object', 'required': ['resource'], 'properties': {'resource': {'enum': ['PEOPLE', 'FILMS', 'PLANETS', 'SPECIES', 'STARSHIPS', 'VEHICLES'], 'type': 'string', 'description': 'Resource type'}}}
sw_random
Returns one random Star Wars entity of the given resource type. Great for live demos. Returns a JSON object.
Read only
Input schema
{'type': 'object', 'required': ['resource'], 'properties': {'resource': {'enum': ['PEOPLE', 'FILMS', 'PLANETS', 'SPECIES', 'STARSHIPS', 'VEHICLES'], 'type': 'string', 'description': 'Resource type'}}}
sw_search
Searches a Star Wars resource by name (title for FILMS), case-insensitive substring match. Returns a JSON array.
Read only Idempotent
Input schema
{'type': 'object', 'required': ['resource', 'query'], 'properties': {'query': {'type': 'string', 'description': 'Name/title fragment'}, 'resource': {'enum': ['PEOPLE', 'FILMS', 'PLANETS', 'SPECIES', 'STARSHIPS', 'VEHICLES'], 'type': 'string', 'description': 'Resource type'}}}
Added
sw_search
Sept. 17, 2026, 7:58 a.m.
Added
sw_random
Sept. 17, 2026, 7:58 a.m.
Added
sw_list
Sept. 17, 2026, 7:58 a.m.
Added
sw_get
Sept. 17, 2026, 7:58 a.m.