# SWAPI MCP for AI Agents AI Agent Connect > SWAPI - The Star Wars. Let your agent query the entire Star Wars universe. Get facts on characters, planets, starships, and species directly from the Star Wars API. It is the quickest way to fact-check lore or fetch consistent placeholder data for your next creative project. ## Overview - **Category:** databases - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_mXpVdfgpxpriksJoCzRNdH2Ib7emp8zVeuCyIUGP/ai-agent-connect - **Tags:** star-wars, swapi, pop-culture, encyclopedia, api-data ## Description You want to know the exact dimensions of the Millennium Falcon or find out which planet a specific character calls home without digging through fan wikis. This Connector gives your agent a direct line to the Star Wars API, turning it into a lore expert that knows the galaxy inside and out. Instead of your agent guessing or hallucinating details, it pulls real data on everything from Imperial Star Destroyers to the diverse species living in the outer rim. It is a great way to ground your creative writing or research in actual canon. If you are building an app and need reliable placeholder data, this makes it easy to grab consistent information without manual copy-pasting. You can find this in the Vinkius catalog to get your agent connected to the lore in seconds. ## Tools ### list_people Find characters by name to see their height, weight, and history. This is great for checking specific character traits. ### get_resource_by_url Fetch a specific resource like a homeworld or a movie using its unique URL. This helps you jump between related data points quickly. ### get_root See the main categories of the Star Wars API to see what is available. It is the best way to explore the overall structure. ### list_films Search for specific movies in the saga or see the full list of films. Use the search parameter to filter by title. ### list_planets Look up planets to see their terrain, climate, and population stats. You can filter by name to find specific worlds. ### list_species Search for different alien species and their biological traits. Use the search parameter to find specific lifeforms. ### list_starships Get technical specs for famous ships like the Millennium Falcon. You can filter results by name or model. ### list_vehicles Find data on ground vehicles and other transport types in the galaxy. This tool helps you find specs for non-spacecraft. ## Prompt Examples **Prompt:** ``` Tell me about the Millennium Falcon's stats. ``` **Response:** ``` The Millennium Falcon (model YT-1300 light freighter) has a max atmosphering speed of 1050 km/h, a hyperdrive rating of 0.5, and can carry up to 6 passengers. ``` **Prompt:** ``` What planets are in the Star Wars universe? ``` **Response:** ``` I found several worlds including Tatooine, Alderaan, Yavin IV, and Hoth. Would you like details on a specific one? ``` **Prompt:** ``` How tall is Darth Vader? ``` **Response:** ``` I found Darth Vader. According to the records, he is 202 cm tall and weighs 136 kg. ``` ## Capabilities ### Search for iconic characters Find physical traits and histories for people like Luke Skywalker. ### Lookup planet details Get data on climates, terrains, and populations for worlds like Tatooine. ### Get starship specs Pull technical details for vehicles like X-wings and cruisers. ### Browse the film saga List every movie in the series to see the timeline. ### Explore alien species Identify the biological traits of various species in the galaxy. ### Navigate related data Jump from a character's profile to their homeworld using direct links. ## Use Cases ### Fact-checking a screenplay A writer asks the agent to confirm if a specific species lives on a specific planet using list_species and list_planets. ### Populating a trivia app A developer uses list_vehicles to get a list of ships for a Guess the Ship game. ### Researching a new story A fan wants to know the climate of a planet to describe a scene accurately using list_planets. ### Building a data map A user wants to see all films and their release dates to visualize the timeline using list_films. ## Benefits - Stop hallucinating lore facts by giving your agent a real-time connection to the Star Wars API. - Save time on research by using list_people to quickly find character heights and weights. - Build better apps faster by pulling structured data from list_planets for your UI elements. - Cross-reference world-building details by using get_resource_by_url to jump between related entities. - Simplify data gathering for projects by using list_starships to get technical specs without manual searching. ## How It Works The bottom line is you get a reliable source of truth for Star Wars lore without needing to manage any API keys. 1. Subscribe to the SWAPI MCP in the Vinkius catalog. 2. Connect your AI client to the Connector. 3. Ask your agent questions about the Star Wars universe to get instant data. ## Frequently Asked Questions **Can the SWAPI MCP help me with my fan fiction?** Yes, it gives your agent access to official lore about characters, planets, and species so you can keep your story consistent with the canon. **Do I need an API key for the SWAPI MCP?** No, this Connector uses a public resource, so you can start querying the Star Wars universe immediately without any setup. **Can my agent find specific starship specs?** Yes, it can pull technical details like speed and passenger capacity for various ships and vehicles. **How do I use the SWAPI MCP to find planets?** Just ask your agent to list planets or search for a specific one like Tatooine to get its climate and population. **Is the SWAPI MCP good for building a trivia game?** It is perfect for that because it provides structured data for people, films, and vehicles that you can use to populate your game. **Can the SWAPI MCP help me find movie release dates?** Yes, your agent can list all the films in the saga to help you organize a timeline or find specific movie info. **How can I find a specific character by their name?** You can use the `list_people` tool and provide the name in the `search` parameter. The agent will return all matching characters from the Star Wars universe. **How do I get more details about a URL found in a result (like a homeworld)?** Use the `get_resource_by_url` tool. Simply pass the full URL (e.g., https://swapi.dev/api/planets/1/) to fetch the complete metadata for that specific resource. **Can I search for starships using their model name instead of their common name?** Yes! The `list_starships` tool allows searching by both name and model. Just enter the model string into the `search` parameter.