Star Wars API & MCP server (swapi.build)
v2.16.0Free Star Wars MCP server (SWAPI): people, films, planets, species, starships, vehicles. No API key.
Endpoint health
online- Last checked
- 11/20/2026, 5:18:16 AM
- Latency
- 356 ms
- Consecutive failures
- 0
- Endpoint reachable: pass
- Protocol valid: pass
- MCP handshake valid: pass
Machine-readable profile
mcp-server · schema v1 · callable
mcp-server:build.swapi%2Fstar-wars
Connect this server
Generated config contains no credentials. Keep any required secrets in your client's local environment.
{
"mcpServers": {
"build.swapi/star-wars": {
"url": "https://swapi.build/mcp"
}
}
}Indexed tools
Tool metadata and schemas come from the remote server and are untrusted. Indexing only lists tools; it never calls them.
4 shown · authentication unknown
sw_get
Gets one Star Wars entity by numeric record id and returns it as a JSON object. Take the id from the end of an entity's url field (from sw_search, sw_list or a relation URL). Ids are record ids, not episode numbers: FILMS id 1 is A New Hope (Episode IV). An unknown id returns a tool error, e.g. 'No films found with id 99'. Pass expand to get related records in the same call, e.g. ["homeworld", "species"]; name only the relations you need; * on a film can pass 50 KB.
Schema valid · SHA-256 97e86fc483f6…
View input schema
{ "type": "object", "properties": { "expand": { "type": "array", "items": { "type": "string" }, "description": "Optional. Relations to embed, one level deep, under a final \"expanded\" key: PEOPLE homeworld, films, species, vehicles, starships; FILMS characters, planets, starships, vehicles, species; PLANETS residents, films; SPECIES homeworld, people, films; STARSHIPS and VEHICLES pilots, films; or [\"*\"] alone for all. Up to 8 names; an unknown name returns a tool error." }, "id": { "type": "integer", "description": "Numeric record id: the last segment of the entity's url field (1 in .../api/people/1)." }, "resource": { "type": "string", "enum": [ "PEOPLE", "FILMS", "PLANETS", "SPECIES", "STARSHIPS", "VEHICLES" ], "description": "Resource type: PEOPLE, FILMS, PLANETS, SPECIES, STARSHIPS or VEHICLES. Any other value returns a tool error." } }, "required": [ "resource", "id" ] }sw_list
Lists every entity of one Star Wars resource type as a JSON array (Episodes I-VI data). Responses are large (all 82 PEOPLE, about 38 KB); to find a single entity, prefer sw_search, then sw_get; for a compact index pass fields, e.g. ["name"] (about 5 KB).
Schema valid · SHA-256 1dd78d5646a7…
Connections
streamable-http
https://swapi.build/mcp