Star Wars API & MCP server (swapi.build)

build.swapi/star-warsVersion 2.16.0

Free Star Wars MCP server (SWAPI): people, films, planets, species, starships, vehicles. No API key.

Status

Responds614 msNov 14, 2026, 13:41 UTCAnswered our handshake without sign-in.

Registry data may be out of date

We could not refresh it, so this page shows the last copy.

Last checked: Nov 14, 2026, 13:41 UTC
Latency: 614 ms
Remotes responding: 1 of 1
Sign-in: No sign-in
Hosting: Hosted outside the EU (detected)
Registry data as of: Nov 14, 2026, 22:14 UTC

Data from the official MCP Registry, checked by run.zero. How we check

Connect

Streamable HTTP

https://swapi.build/mcpResponds614 msNov 14, 2026, 13:41 UTC

No sign-in

Claude Code

claude mcp add --transport http star-wars https://swapi.build/mcp

Claude Desktop and claude.ai

1
2
3

Settings > Connectors > Add custom connector
Name: star-wars
Remote MCP server URL: https://swapi.build/mcp

Cursor

{
  "mcpServers": {
    "star-wars": {
      "url": "https://swapi.build/mcp"
    }
  }
}

VS Code

code --add-mcp '{"name":"star-wars","type":"http","url":"https://swapi.build/mcp"}'

Built your own server? run.zero hosts MCP servers on European infrastructure.

Host your own MCP server on run.zero

Tools

4 tools

Tools of Star Wars API & MCP server (swapi.build)
	Description		Read-only	Idempotent	Open world
`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.	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.	No	Yes	Yes	No
`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).	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).	No	Yes	Yes	No
`sw_random`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.	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.	No	Yes	No	No
`sw_search`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.	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.	No	Yes	Yes	No

Details

Registry status: Active
Published: Nov 12, 2026
Updated: Nov 12, 2026
Website: https://swapi.build/⁠ (opens in a new tab)
Repository: https://github.com/eldermoraes/swapi.build⁠ (opens in a new tab)
Categories (suggested): Design and mediaSuggested categories are assigned automatically from the registry text and may be wrong. Verified operators can correct them.
GDPR: Not declared

Are you the operator? Claim this listing