Star Wars API & MCP server (swapi.build)

Connect it to your AI

Claude Code

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

Claude, ChatGPT, Cursor and other apps

Add it as a custom connector with this URL (Streamable HTTP):

https://swapi.build/mcp

Cursor, VS Code and other apps (mcp.json)

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

Tools it offers

4 tools, as the server itself reported during our check on Oct 31, 2026.

• sw_getGets 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: FILM
• sw_listLists 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 f
• sw_randomReturns 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_searchStart 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

Questions