Star Wars API & MCP server (swapi.build)
Server Details
Free Star Wars MCP server (SWAPI): people, films, planets, species, starships, vehicles. No API key.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- Repository
- eldermoraes/swapi.build
- GitHub Stars
- 4
- Server Listing
- swapi-build
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 4 tools
Each tool maps to a clearly distinct retrieval mode: sw_get by id, sw_search by name substring, sw_list for full enumeration, and sw_random for non-deterministic picks. The descriptions explicitly guide when to prefer one over another (e.g. 'Start here' for sw_search, use sw_get for specific entities), leaving no meaningful overlap.
All four tools follow the same sw_<verb> pattern (get, list, random, search) with snake_case throughout. The prefix cleanly scopes the set to Star Wars and the verbs are predictable and readable.
Four tools is well-scoped for a read-only public dataset API, and each earns its place by covering a distinct access pattern. There is no bloat and no tool that could be folded into another without losing functionality.
The core read workflows (search, get-by-id, enumerate, random, plus relation expansion via expand) are covered with no dead ends. Minor gaps remain: no tool to discover available resource types/schema and no pagination or server-side filtering for large list results, though the descriptions mitigate this by recommending sw_search and the fields parameter.
Available Tools
4 toolssw_getARead-onlyIdempotentInspect
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.
Inputs: id (required), resource (required), expand.
sw_listARead-onlyIdempotentInspect
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).
Inputs: resource (required), fields.
sw_randomARead-onlyInspect
Returns one random Star Wars entity of the given resource type as a JSON object. Each call can return a different entity, so it is not idempotent. Useful for demos and quizzes; to fetch a specific entity use sw_search or sw_get.
Inputs: resource (required).
sw_searchARead-onlyIdempotentInspect
Start here. Finds Star Wars entities by name (title for FILMS) with a case-insensitive substring match: 'sky' finds Luke, Anakin and Shmi Skywalker. Returns a JSON array of full entities; an empty array [] means no match; pass fields to shorten each entity. The id to pass to sw_get is the last segment of each entity's url field. Data covers Episodes I-VI only.
Inputs: query (required), resource (required), fields.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
SWAPI MCP — wraps the Star Wars API (free, no auth)
Rick and Morty MCP — wraps The Rick and Morty API (free, no auth)
Unofficial Rick and Morty MCP — wraps the Rick and Morty API (free, no auth)
MCP server exposing live Helldivers 2 galactic war data.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceMCP server for querying the Star Wars universe via the SWAPI API, providing access to characters, films, starships, vehicles, species, and planets.ISC
- AlicenseNot gradedqualityCmaintenanceProvides keyless access to a fan-built API of animated films, characters, locations, species, and vehicles, enabling list retrieval, single-item lookups, and plain-language queries through MCP tools.90 npmMIT
- FlicenseBqualityDmaintenanceA Model Context Protocol server that exposes Star Wars API data as MCP tools. It enables users to list available categories and retrieve character information.363 npm-
- AlicenseNot gradedqualityDmaintenanceEnables LLMs and clients to search for Star Wars characters, planets, and films by exposing SWAPI as MCP tools.1MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.