# Amiibo MCP > Amiibo provides direct access to Nintendo's collectible database via an MCP connection. Use this toolset to search, filter, and retrieve precise metadata on Amiibos by name, character, game series, or type. Check the status of the entire catalog, look up a specific figure by its 16-digit ID, and browse every known series in one place. ## Overview - **Category:** databases - **Price:** Free - **Tags:** amiibo, nintendo, collectibles, gaming-data, character-database ## Description The Amiibo MCP lets your agent explore Nintendo's massive line of collectibles without needing to hit an external website. You can query everything from figures and cards to plushies using natural conversation with any compatible AI client. Need to find all the characters associated with a specific game or check which types of items exist? This connector handles it all. If you’re tracking inventory or building apps around pop culture data, this is your source. It's hosted on Vinkius, so once you connect your agent, you get access to thousands of other specialized databases too. You simply ask for the data—whether you need a character list, a full series breakdown, or just details on one item—and it gets returned immediately. ## Tools ### get_amiibo Retrieves all metadata for a single Amiibo figure using its unique 16-digit ID. ### get_last_updated Returns the date and time when the Amiibo database was last synchronized. ### list_amiibo_series Fetches a complete list of all established Amiibo product lines or collections. ### list_amiibos Searches and filters the entire collection by name, character, game series, or type segments. ### list_characters Provides a list of every distinct character available in the Amiibo database. ### list_game_series Lists all video game franchises that have associated Amiibo products. ### list_types Returns a list of physical formats, such as Figure or Card, available for collectibles. ## Prompt Examples **Prompt:** ``` List all Mario Amiibos from the Super Smash Bros. series. ``` **Response:** ``` I've found several Mario Amiibos in the Super Smash Bros. series, including the standard Mario figure (ID: 0000000000000002) and Gold/Silver variants. Would you like the details for a specific one? ``` **Prompt:** ``` Show me all available Amiibo types. ``` **Response:** ``` The available Amiibo types are: Figure, Card, and Yarn. Most collectibles are Figures, but there are extensive Card collections for series like Animal Crossing. ``` **Prompt:** ``` When was the Amiibo database last updated? ``` **Response:** ``` The Amiibo database was last updated on 2024-03-15. This ensures you have access to the most recent release information and metadata. ``` ## Capabilities ### Search entire collections You can list figures and cards by applying multiple filters like name, character, game series, and type simultaneously. ### Retrieve item details by ID Give the agent a unique 16-digit identifier to pull all specific metadata about one Amiibo figure. ### Discover data scope List every available character, game series, or physical type of collectible that exists in the database. ### Verify catalog freshness Check the timestamp to confirm when the entire Amiibo database was last updated with new releases. ## Use Cases ### Building a cross-platform inventory tracker The developer needs to track every Amiibo for 'Pokémon' across different games. They call `list_game_series` to confirm the correct franchise, then use that result to filter all records with `list_amiibos`, ensuring no series are missed. ### Quickly checking a specific item A collector finds an old Amiibo box and needs to know exactly what it is. They provide the 16-digit ID to `get_amiibo(id)`, getting all the required metadata immediately, without manual cross-referencing. ### Understanding data boundaries A new user needs to know if Card Amiibos exist for a game. They call `list_types` first to see available formats, confirming that 'Card' is indeed an option before attempting any complex searches. ### Drafting comprehensive data reports A researcher needs a report on all characters released in the Super Smash Bros. series. They use `list_characters` to get names, then call `list_amiibos` with filters for both 'Super Smash Bros.' and the relevant character name. ## Benefits - Stop guessing what data exists. Use `list_types` to see if the Amiibos are Figures, Cards, or something else entirely before building your query. - Need a full list of all possible characters? Call `list_characters` first. This ensures you have every name available for filtering in later steps. - Tracking series is fast. Start with `list_game_series`, then use the resulting data to filter Amiibos using `list_amiibos`. It’s a two-step process that guarantees accurate results. - When developing an inventory tracker, you don't want stale data. Run `get_last_updated` first to verify the catalog is current before running any major searches. - Pinpoint specific items instantly. If you know the ID, use `get_amiibo(id)` instead of searching; it’s faster and more direct. ## How It Works The bottom line is, you get clean, actionable Amiibo metadata returned instantly through your agent without writing any HTTP requests yourself. 1. Subscribe to this MCP on Vinkius. No API key is required for the public AmiiboAPI. 2. Your agent calls a specific tool, like `list_amiibos`, specifying filters (e.g., 'Super Mario' or 'Card'). 3. The MCP executes the query against the database and returns structured JSON data directly to your AI client. ## Frequently Asked Questions **How do I find all the different kinds of Amiibos available?** You call `list_types`. This tool provides a list of the physical formats, such as Figure, Card, and Yarn, which tells you what kind of collectibles exist in the database. **What should I use to search for Amiibos by character?** Use `list_amiibos` and include the character name as a filter. This is much more reliable than just listing characters first, because it links the data points together. **Do I need an API key to use `get_amiibo`?** No, you don't. The AmiiboAPI is public, so once connected via Vinkius, your agent can run `get_amiibo` without requiring any private credentials. **How do I know if the data is up-to-date?** Run `get_last_updated`. This call gives you a timestamp that confirms when the entire collection's metadata was last synchronized, so you know your search results are based on recent info. **How do I use `list_amiibos` to find items that fit multiple criteria, like a specific type and game series?** You combine filtering parameters directly within the `list_amiibos` tool. This lets your agent narrow down results by two or more criteria simultaneously. For instance, providing both the desired type and the corresponding series ID ensures you get only matching items. **If I run `get_amiibo` with an invalid or non-existent 16-digit Amiibo ID, what response should my agent expect?** The tool returns a structured error message confirming the ID is not found. Your AI client can then immediately confirm if you need to adjust your search parameters or check the available IDs using other listing tools. **How do I retrieve an exhaustive list of all known Amiibo collectible series?** Run the dedicated `list_amiibo_series` tool. This provides a complete record of every recognized collection line, letting you know what search scopes are available before you run any general query. **To map out all potential metadata fields, should I use which tools?** Use both `list_types` and `list_characters`. Running these listing tools helps your agent see the full structure of the data—what types exist (Figure, Card) and what characters are associated with those items. **How can I filter Amiibos by a specific game series like Super Smash Bros.?** You can use the `list_amiibos` tool and provide the series name in the `amiiboseries` or `gameseries` parameter. The agent will return all matching figures and cards from that collection. **Can I see all the different characters that have Amiibo versions?** Yes! Use the `list_characters` tool to retrieve a complete list of every character represented in the Amiibo database. **How do I get the specific details of a single Amiibo if I have its ID?** Simply provide the 16-digit ID to the `get_amiibo` tool. It will return detailed information including the character, series, release dates, and image URL.