# Nookipedia MCP > Nookipedia provides direct access to the entire Animal Crossing API, allowing your AI agent to query complex game data instantly. Check villager stats by name or species, pull real-time catalog information for bugs, fish, and fossils, and retrieve crafting requirements for every DIY recipe. It’s an encyclopedia for the whole series, handling everything from New Horizons furniture details to historical collectible tracking. ## Overview - **Category:** databases - **Price:** Free - **Tags:** animal-crossing, nintendo, villagers, new-horizons, encyclopedia ## Description Look, forget the messy wikis you gotta dig through on your phone. This server gives your AI agent straight access to the whole Animal Crossing API—it's like having the master data vault for every single thing that happens in the game series. When you pull from this MCP Server, you get structured data fast. You can check villager stats by name or species, track down real-time catalog info on bugs and fish, and figure out exactly what materials you need for any DIY recipe. It's the encyclopedia, period. **Villagers:** If you wanna know something about a resident, use `get_villagers`. You can get detailed profiles on any villager across the whole series, filtering by name, species, or even their personality type. This tool gives you everything—birthdays, catchphrases, and style details. **The Habitat Catalog:** For all the stuff that pops up in New Horizons (NH), you've got dedicated endpoints. You can pull structured data on furniture using `get_nh_furniture`, grab details about clothing items with `get_nh_clothing`, or look up specific tools with `get_nh_tools`. If you're decorating, `get_nh_interior` handles all the wallpaper and decoration metadata. Need to know about those cool architectural pieces? Use `get_nh_gyroids` for dedicated details on decorative gyriods. **Collectibles & Decor:** You can track down artwork using `get_nh_art`, which pulls info on New Horizons specific paintings and posters. For general miscellaneous items, use `get_nh_misc`. To map out your island's aesthetic, check photos and poster details with `get_nh_photos`. **The Natural World:** You don't wanna waste time wandering around just to find a bug or fossil. Use `get_nh_bugs` for the full list of bugs found in NH, and get fish data instantly with `get_nh_fish`. Fossils are handled by `get_nh_fossils`, while sea life is covered by two tools: you can get general details on sea creatures using `get_nh_sea_creatures`, or check out specific fish listings with `get_nh_fish`. **Making Stuff & Planning:** Need to craft something? `get_nh_recipes` pulls up all the DIY crafting recipes, telling you exactly what materials and items are needed. Wanna know when that big seasonal party is happening? `get_nh_events` gives you info on NH events and their dates. If you're looking for specific structural pieces of content, like general information about sea creatures or tools available in New Horizons, those details live under `get_nh_sea_creatures` and `get_nh_tools`, respectively. **Summary:** You can also pull the specifics on things that make up your island's lifeblood. Use `get_nh_bugs` for all insects, `get_nh_furniture` for every chair and table, `get_nh_interior` for wall coverings, and `get_nh_photos` if you're collecting art. This server gives your agent a complete data layer over the entire game world. ## Tools ### get_nh_art Retrieves data on New Horizons artworks. ### get_nh_bugs Gets a list of bugs found in New Horizons. ### get_nh_clothing Retrieves clothing items available in New Horizons. ### get_nh_events Pulls information on New Horizons events and their dates. ### get_nh_fish Gets a list of fish found in New Horizons. ### get_nh_fossils Retrieves information on fossils from New Horizons. ### get_nh_furniture Gets structured data about furniture items in New Horizons. ### get_nh_gyroids Retrieves details on gyroid decorative pieces from New Horizons. ### get_nh_interior Gets information about interior decorations in New Horizons. ### get_nh_misc Retrieves general miscellaneous items from New Horizons. ### get_nh_photos Gets details on photos and posters in New Horizons. ### get_nh_recipes Retrieves crafting recipes for DIY items in New Horizons. ### get_nh_sea_creatures Gets a list of sea creatures found in New Horizons. ### get_nh_tools Retrieves information on tools available in New Horizons. ### get_villagers Gets comprehensive details about any villager, filterable by name, species, or personality. ## Prompt Examples **Prompt:** ``` Tell me everything about the villager named Raymond. ``` **Response:** ``` I've found Raymond! He is a Smug cat villager who first appeared in New Horizons. His birthday is October 1st, and his initial catchphrase is 'crisp'. Would you like to know his preferred clothing styles or his home interior? ``` **Prompt:** ``` What fish can I catch in New Horizons? ``` **Response:** ``` I've retrieved the fish catalog for New Horizons. There are 80 different fish in total, ranging from the common Sea Bass to the rare Coelacanth. I can filter these by location (river, pond, sea) or by their selling price. What are you looking for? ``` **Prompt:** ``` List all the DIY recipes available in the game. ``` **Response:** ``` Fetching DIY recipes... I've found a wide variety of recipes including furniture, tools, and seasonal items. For example, the 'Acoustic Guitar' requires 8 softwood and 3 iron nuggets. Would you like to see recipes for a specific category? ``` ## Capabilities ### Query Villager Profiles You can retrieve detailed information about any villager across the game series using `get_villagers`. ### Fetch Catalog Items by Type Use specialized tools like `get_nh_furniture`, `get_nh_clothing`, or `get_nh_tools` to pull structured data on specific item sets. ### Check Critter Availability Retrieve real-time data for bugs (`get_nh_bugs`), fish (`get_nh_fish`), and fossils (`get_nh_fossils`). ### Track DIY Recipes Access crafting recipes, including the exact materials needed, using `get_nh_recipes`. ### Lookup Game Events Get information on in-game seasonal events and their dates via `get_nh_events`. ## Use Cases ### Designing a themed island A designer needs to build an entire Tudor-themed house. Instead of manually checking the game for compatible items, they ask their agent: 'What furniture and interior pieces match the Tudor style?' The agent runs `get_nh_furniture` combined with `get_nh_interior`, providing a curated list of IDs and names, solving the planning headache instantly. ### Figuring out rare catches A player is fishing or exploring. They ask: 'What sea creatures are available right now?' The agent runs `get_nh_sea_creatures` and compares that with `get_nh_fish`, immediately showing them which resources they can collect today, saving hours of blind wandering. ### Writing a fan story character The writer needs a new villager for their story. They prompt: 'Give me details on a Smug-type cat villager.' The agent uses `get_villagers`, returning accurate data on species, personality, and potential catchphrases, making the lore factually solid. ### Completing a museum exhibit The curator realizes they are missing fossil types. They prompt: 'What fossils can I donate?' The agent runs `get_nh_fossils`, showing them the exact list of required specimens and their availability, allowing them to focus collection efforts immediately. ## Benefits - Need to plan a whole room? Call `get_nh_furniture` and `get_nh_interior`. You get metadata for thousands of items, so you don't have to open 17 different tabs just to compare wallpapers and chairs. - Tracking your collection? Use `get_nh_photos` or `get_nh_gyroids` to check specific item statuses without leaving the chat. It’s instant verification on posters and elusive decorative pieces. - Got a friend's name? Run `get_villagers` and you pull their birthday, species, and catchphrase in one go. No more guessing or cross-referencing multiple wikis for basic lore. - Stuck on crafting something? Don't guess the materials. Use `get_nh_recipes` to see exactly what seeds, wood, or nuggets are needed for any DIY item. - Checking your museum progress? You can use tools like `get_nh_bugs` and `get_nh_fossils` together to quickly catalog every critter type you're missing. ## How It Works The bottom line is: your AI client talks to Nookipedia using specific tool calls instead of searching random websites. 1. First, subscribe to the Nookipedia server and input your API key. This gives your AI client access to the entire Animal Crossing database. 2. Next, you call a specific tool function (e.g., `get_nh_bugs`) and pass necessary parameters like location or name. 3. Your agent receives clean, structured data—whether it's a list of fish names or a villager's birthday—and uses it in the conversation. ## Frequently Asked Questions **How do I find out everything about a villager using get_villagers?** Just ask your agent to run the `get_villagers` tool and provide the name. It pulls their species, personality, catchphrase, and birthday right away. **Can I use Nookipedia MCP Server to check for new crafts?** Yep. Use `get_nh_recipes`. You can list all recipes or filter by specific required materials to see what you're missing in your inventory. **What is the best tool for checking furniture? Is it get_nh_furniture?** Yes, `get_nh_furniture` handles general items. If you’re looking specifically at room decorations and wallpapers, use `get_nh_interior` instead. **How do I find out what fish are available in New Horizons?** Run the `get_nh_fish` tool. It gives you a catalog of all species, allowing you to filter by location or selling price for your next fishing trip. **Can get_villagers help me plan a museum donation?** While it focuses on villager data, the server has `get_nh_fossils` and `get_nh_bugs`, which are the tools you need to track donations for your Museum Curator goals. **Before using get_villagers, how do I ensure my AI agent has access to the required Nookipedia API key?** You connect the server on Vinkius and pass your unique API key as part of your agent's configuration. Once that initial setup is done, your client handles authentication automatically for every call, letting you query any tool instantly. **If I run multiple searches using tools like get_nh_fish and get_nh_furniture, are there rate limits?** The server manages standard throttling to prevent excessive calls. If your agent hits a limit, it receives a specific 429 error code. For heavy workflows, you should space out high-volume tool calls or implement an intermediary queue system. **When using get_nh_events, can I restrict the data to a specific date range?** You specify date filters directly in the tool call parameters for functions like `get_nh_events`. This lets your agent pull only relevant data—for example, just holiday events from last year's records—without needing to filter it manually. **Can I search for villagers based on their personality or species?** Yes! The `get_villagers` tool allows you to filter by name, species (e.g., 'Cat'), and personality (e.g., 'Lazy') to find exactly who you are looking for. **Does this server provide information on how to craft items in New Horizons?** Absolutely. Use the `get_nh_recipes` tool to fetch a list of DIY recipes, which includes the materials required for crafting each item. **Can I check which bugs or fish are available right now?** Yes. By using `get_nh_bugs` or `get_nh_fish`, your AI agent can retrieve the full encyclopedia data, including the months and times of day each creature appears.