# Rick and Morty MCP > Rick and Morty MCP Server queries a complete database of the show's multiverse. It lets your AI agent find detailed info on 200+ characters, track planets across dimensions, or pull up full episode guides—all from natural language prompts. You can search by status (alive/dead), filter locations by type (Planet/Dimension), and retrieve batches of data in a single query. ## Overview - **Category:** artificial-intelligence - **Price:** Free - **Tags:** api-integration, character-database, media-data, rest-api, entertainment-data ## Description **The `get_character` tool lets you pull up full profiles for any single character in the multiverse.** You're not looking at some fan wiki; this is structured data. Use it to get every detail on one designated person—their species, where they originated, and if they're still alive or dead. It’s quick, precise data lookup. **When you need to filter a roster of characters, use `list_characters`**. You can narrow down the cast by checking their status (are they alive or dead?), filtering by gender, identifying their species, or just searching by name. This tool gives you a manageable list based on your criteria. If you're pulling data for multiple people at once, **use `get_characters`**. That lets you grab profiles for several characters in one go, saving you time querying them individually. *** **For location deep dives, start with the `get_location` tool.** You plug in a specific spot or dimension name and it spits out all the detailed info on that single place—its type and its coordinates within the multiverse. It’s your one-shot source for dimensional data. **The `list_locations` tool lets you browse every known area across the show's dimensions.** You can filter these spots by their type, like 'Planet' or 'Dimension,' or search them directly by name. This is how you get a full rundown of the map. If you know exactly which locations you need data for, **use `get_locations`**. That lets your agent grab multiple location profiles simultaneously in one single API call. You don't have to query every spot individually; it’s faster that way. *** **Need the scoop on a specific episode? Start with `get_episode`**. This tool gives you comprehensive details for just one installment, including its air date and who was in the cast. It pulls all that info together in one packet of data. **If you're trying to track several episodes at once, use `get_episodes`**. That lets you retrieve a batch of episode data simultaneously, saving you from doing multiple calls for different parts. To find out what episodes exist or filter them down, **use `list_episodes`**. You can narrow your search by the episode code (like SXXEXX) or just by its name. This is how you get a filtered list of available shows and movies across the timeline. **Finally, when you need to check multiple places at once, use `get_locations` for location data, `get_characters` for character profiles, or `get_episodes` for episode guides.** These batch tools let your agent handle massive amounts of structured data in a single request. You're always working with the whole database—the characters, the dimensions, and every damn episode guide—all accessible through natural language prompts. ## Tools ### get_character Retrieves detailed information for a single specified character. ### get_characters Fetches profiles for multiple characters simultaneously. ### get_episode Gets full details (cast, date) for one specific episode. ### get_episodes Retrieves data for several episodes at once. ### get_location Gets detailed information about a single location or dimension. ### get_locations Fetches profiles for multiple locations simultaneously. ### list_characters Lists and filters characters by status, species, gender, or name. ### list_episodes Lists and filters episodes using their code (SXXEXX) or name. ### list_locations Lists and filters places based on type (Planet, Dimension) or name. ## Prompt Examples **Prompt:** ``` Show me all alive human characters. ``` **Response:** ``` Found 42 alive human characters including Morty Smith, Summer Smith, Jerry Smith, Beth Smith, and many others. Want details on any of them? ``` **Prompt:** ``` Tell me about Rick Sanchez. ``` **Response:** ``` Rick Sanchez (ID: 1) is an alive Human male, status: Alive. Origin: Earth (C-137). Current location: Earth (C-137). He has appeared in 51 episodes across all seasons. ``` **Prompt:** ``` What happened in episode S01E01? ``` **Response:** ``` S01E01 is 'Pilot' — the first episode of Rick and Morty, aired on December 2, 2013. It features 16 characters including Rick Sanchez, Morty Smith, Jerry Smith, Summer Smith, and Beth Smith. This is the iconic origin episode where Rick moves in with the Smith family. ``` ## Capabilities ### Find specific character data Retrieves full profiles (species, origin, status) for one designated character. ### Filter and list characters Returns a filtered roster of characters based on criteria like species, gender, or whether they are alive or dead. ### Locate specific dimensions or planets Gets detailed information about a single location, including its dimension and type. ### Browse all known locations Retrieves a filtered list of places across the multiverse using criteria like 'Planet' or 'Dimension'. ### Get full episode details Pulls comprehensive information for one specific episode, including its air date and character cast. ### Batch data retrieval Grabs multiple characters, locations, or episodes in a single API call. ## Use Cases ### The Lore Master Needs a Roster A writer needs to verify every character who appears in the Season 5 finale, but they can't remember all the names. They prompt their agent: 'List all characters that are Human and alive.' The agent uses `list_characters` to return an accurate, filtered list of names and species, letting them check off their story bible instantly. ### Tracking a Specific Dimension A game designer is building a level set in a specific dimension but needs to know if there are any known facilities or planets nearby. They ask the agent to use `list_locations` and filter by 'Dimension Name: XYZ'. This returns all relevant coordinates and location types, letting them build their map accurately. ### Comparing Character Stats A researcher wants to compare Rick Sanchez and Morty Smith's full profiles. Instead of looking up each person separately, they ask the agent to use `get_characters` with both IDs. This pulls all data—origin, status, appearance count—into one structured block for direct comparison. ### Checking Episode Continuity A student is writing a paper on time travel and needs details about the first episode (S01E01). They ask to run `get_episode` with that code. The agent returns the full summary, air date, and a complete list of 16 characters involved in the plot. ## Benefits - Stop sifting through wiki pages. Use `list_characters` to instantly filter the entire roster by status (alive/dead) or species, giving you a clean list of relevant characters. - Need to track plot points? Run `get_episode` with an episode code to pull up full cast lists and air dates without leaving your chat interface. - The multiverse is huge. Use `list_locations` to filter down from every dimension to only the 'Planet' type, narrowing your search quickly by name or dimension tag. - Don't call tools one-by-one. Pass a batch request using `get_characters` or `get_locations` to pull multiple records in a single shot, saving time and tokens. - Get deep character context. Use `get_character` when you need specifics—like knowing an alien’s exact origin point (C-137) rather than just their name. ## How It Works The bottom line is: you talk to your AI client; the client talks to this server using specific tools; the server gives back clean, usable JSON data. 1. Subscribe to the server. No API key is needed; the Rick and Morty API is open. 2. Your AI client sends a natural language query (e.g., 'Find all human characters in dimension C-137'). 3. The agent selects the necessary tool (`list_characters` or `get_location`), runs it, and returns structured data to your workflow. ## Frequently Asked Questions **How do I check if characters are alive or dead using list_characters?** You filter by status directly in the prompt. Just tell your agent, 'List all characters with status: Dead.' The `list_characters` tool handles this filtering immediately. **Do I need to use get_locations for every planet?** No. If you only want a quick list of potential places and their types, use `list_locations`. Use `get_location` only when you need deep details on one specific place, like its full dimensional coordinates. **What’s the difference between get_characters and list_characters?** Use `list_characters` when you want a filtered roster (e.g., 'Show all female characters'). Use `get_characters` when you already know several specific character IDs and need their full profiles in one batch. **Can I find episode details using list_episodes?** No, not really. If you want a filtered *list* of episodes by name or code, use `list_episodes`. But if you know the exact code and need full cast/air date details, you must run `get_episode`. **When using `list_characters`, what filters can I use besides just name or status?** You can filter by species, type, and gender. This lets you pinpoint specific character groups without having to retrieve the full database first. **If I need data for several dimensions, is it better to use `get_locations` or `get_multiple`?** You should use `get_locations`. It handles multiple records in one request. This reduces the number of calls and improves overall execution performance. **Do I need an API key to access tools like `get_characters` or any other function?** No, you don't. The Rick and Morty API is free and open, so there’s no authentication setup required from your end. **When using `list_episodes`, what format do I need to use for the episode codes?** You must use the standard season and episode code format, like 'S01E01'. Using this structured input ensures the API accurately identifies the specific installment you're looking for. **Do I need an API key or account?** No! The Rick and Morty API is completely free and open with no authentication required. Just subscribe and start exploring. **Can I filter characters by whether they're alive or dead?** Yes! Use the `list_characters` tool with the `status` parameter set to `alive`, `dead`, or `unknown`. You can combine it with other filters like species or name. **Can I see which characters appear in a specific episode?** Yes! Use `get_episode` with the episode ID to get the full list of character URLs, or use `list_episodes` filtered by episode code (e.g., 'S01E01') to find it first.