# Poké MCP for AI Agents AI Agent Connect > Poké MCP connects your AI agent to the full PokéAPI database. It lets you query berries, contest mechanics, encounter methods, and evolution chains instantly. Use it to pull accurate Pokémon facts for game design, wiki building, or data research without leaving your chat interface. ## Overview - **Category:** data-management - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_dYe7AcpT72WfrY65v4EDiZcYFyasasRtZ0P0aLKd/ai-agent-connect - **Tags:** api-integration, gaming-data, encyclopedia, rest-api, data-retrieval ## Description Imagine you're deep in a design doc or building a fan wiki and you need to know exactly how many berries are available or what specific move appeals work for a cool type contest. Usually, that means opening a new tab, hunting for a wiki, and cross-referencing multiple pages. This Connector changes that by giving your AI agent a direct line to the PokéAPI. You can ask your agent to pull specific data points like berry firmness, item categories, or even the exact conditions needed for an encounter in a specific region. It's like having a live encyclopedia that your agent can browse for you. Whether you're checking evolution triggers or mapping out location areas, the data comes straight to your chat. Because Vinkius makes it so easy to manage these connections, you can jump from a high-level design discussion to specific data retrieval in seconds. You stop hunting for facts and start using them. ## Tools ### get_encounter_condition Find the conditions for wild encounters. Helps with world-building. ### get_encounter_condition_value Get specific values for encounter conditions. Use this for precise data. ### get_encounter_method See how Pokémon are encountered. This covers methods like fishing or surfing. ### get_evolution_chain Get the full evolution path for a species. Helps with lineage research. ### get_generation Get data on specific Pokémon generations. Helps with historical context. ### get_item_attribute Get attributes for specific items. Useful for item mechanics. ### get_item_category Get details on item categories. Helps organize item data. ### get_item_fling_effect See the effect of flinging an item. Useful for specific battle tactics. ### get_item_pocket See which pocket an item belongs in. Helps with inventory logic. ### get_item Get full details on a specific item. Use this for general item queries. ### get_location_area Get details on a specific location area. Helps with map data. ### get_location Get details on a specific location. Useful for geographic data. ### get_region Get details on a specific region. Useful for world-building. ### get_super_contest_effect Get details on super contest effects. Use this for advanced contest research. ### get_version_group Get details on version groups. Helps with multi-generational context. ### list_encounter_conditions List all encounter conditions. Use this for a full list of encounter rules. ### list_items List all items in the database. Good for a full item overview. ### list_locations List all locations. Helps browse all geographic points. ### list_pal_park_areas List all Pal Park areas. Use this for specific area lists. ### list_pokedexes List all pokedexes. Helps see all game-specific pokedexes. ### list_super_contest_effects List all super contest effects. Helps browse all super contest results. ### get_version Get details on a specific game version. Useful for version-specific data. ### get_berry_firmness Get specific firmness levels for berries. This helps with precise flavor data. ### get_berry_flavor Pull flavor profiles like spicy or sweet. Useful for identifying berry types. ### get_berry Get full details on a specific berry. Use this for comprehensive berry data. ### get_contest_effect See how moves perform in contests. Helps with move appeal research. ### get_contest_type Get details on contest categories. Useful for understanding competition styles. ### get_evolution_trigger See what triggers an evolution. Useful for mechanic design. ### get_pal_park_area Get details on Pal Park areas. Specific to certain game regions. ### get_pokedex Get pokedex details for a specific version. Helps with game-specific data. ### query_graphql Execute a GraphQL query against PokéAPI. Use this for complex, custom data requests. ### list_berries List all berries in the database. Good for getting a full overview. ### list_berry_firmnesses List all berry firmness levels. Use this to see all available firmnesses. ### list_berry_flavors List all berry flavors. Useful for seeing all flavor types. ### list_contest_effects List all contest effects. Helps browse all available contest results. ### list_contest_types List all contest types. Use this to see all contest categories. ### list_encounter_condition_values List all encounter condition values. Helps browse all condition types. ### list_encounter_methods List all encounter methods. Helps see all ways to find Pokémon. ### list_evolution_chains List all evolution chains. Useful for browsing all species lineages. ### list_evolution_triggers List all evolution triggers. Use this to see all triggering mechanics. ### list_generations List all Pokémon generations. Helps with broad historical data. ### list_item_attributes List all item attributes. Use this to see all available attributes. ### list_item_categories List all item categories. Helps browse all item types. ### list_item_fling_effects List all item fling effects. Use this to see all fling results. ### list_item_pockets List all item pockets. Helps see all inventory slots. ### list_location_areas List all location areas. Use this for a full list of areas. ### list_regions List all regions. Use this for a full list of regions. ### list_version_groups List all version groups. Use this for a full list of version groups. ### list_versions List all game versions. Helps browse all game versions. ## Prompt Examples **Prompt:** ``` What are the different ways to find Pokémon in the wild? ``` **Response:** ``` I've found several encounter methods for you: * **Walk**: Walking in tall grass * **Old Rod**: Fishing with an old rod * **Surf**: Moving across the water surface * **Headbutt**: Shaking trees to find hidden Pokémon Would you like more details on any of these specific methods? ``` **Prompt:** ``` Give me a list of berries and their flavors. ``` **Response:** ``` Here are some of the berries available in the database along with their flavor profiles: | Berry | Flavor | Firmness | | :--- | :--- | :--- | | **Cheri** | Sweet | Soft | | **Chesto** | Dry | Soft | | **Pecha** | Spicy | Soft | | **Rawst** | Dry | Firm | I can pull a full list for you if you'd like! ``` **Prompt:** ``` What happens if I use a cool move in a contest? ``` **Response:** ``` In a **Cool** type contest, your move appeal depends on how well it fits that style. * **Effect**: Using moves with high 'cool' appeal will yield higher points from the audience. * **Context**: This is one of the primary contest types used to showcase style. Would you like to see the full list of contest types or specific move effects? ``` ## Capabilities ### Pull berry flavor and firmness details Get specific flavor profiles and firmness levels for all berries in the database. ### Look up contest types and move effects Retrieve details on contest categories and how specific moves perform in competitions. ### Check wild encounter methods and conditions Find out how Pokémon are encountered in the wild, including methods like fishing or surfing. ### Get evolution chains and specific triggers Retrieve full evolution paths and the specific mechanics that trigger them. ### Browse item attributes and categories Access detailed data on items, including categories, pockets, and fling effects. ### Query regional and location data Get information on specific regions, location areas, and Pal Park areas. ## Use Cases ### Checking item inventory logic A game designer wants to check if a specific item belongs in a certain pocket to keep inventory logic consistent. They ask the agent to check get_item_pocket. ### Building a comprehensive encounter guide A content creator is writing a guide on wild encounters. They ask the agent to list all list_encounter_methods to ensure they don't miss any. ### Verifying evolution mechanics A fan is trying to figure out why a Pokémon won't evolve. They ask the agent to check the get_evolution_trigger for that specific species. ### Populating a region map A developer is building a region map and needs to know all available areas. They use list_location_areas to populate their database. ## Benefits - Stop manual searching for berry flavors with list_berry_flavors. - Design balanced game mechanics using get_evolution_trigger and get_evolution_chain. - Build accurate wikis by pulling specific data with get_item and get_location. - Research competition styles quickly using list_contest_types. - Map out game worlds accurately with list_regions and list_location_areas. - Run complex custom queries on the fly with query_graphql. ## How It Works The bottom line is you get instant access to structured Pokémon data without manual searching. 1. Subscribe to the Poké MCP on the Vinkius Marketplace. 2. Connect your preferred AI client to the Connector. 3. Ask your agent to retrieve specific Pokémon data points like berry flavors or evolution chains. ## Frequently Asked Questions **Can the Poké MCP help me write a Pokémon wiki?** Yes, it can. It pulls facts directly from the PokéAPI, allowing your agent to provide accurate data on berry flavors, items, and encounter methods for your wiki pages. **How does Poké MCP help game developers?** It provides structured data on game mechanics like evolution triggers, item attributes, and pokedex details, helping you keep your game design consistent with official data. **Can I use Poké MCP to find berry flavors?** Yes, you can. The Connector can list all berry flavors and firmness levels, making it easy to verify details for recipes or game items. **Does Poké MCP work with Claude?** Yes, Poké MCP works with Claude and any other MCP-compatible client like Cursor or Windsurf to bring Pokémon data into your chat. **Can I get specific location data with Poké MCP?** Yes, it can retrieve details on specific regions, location areas, and even Pal Park areas to help you map out game environments. **Is Poké MCP good for checking evolution chains?** It's perfect for that. You can ask your agent to retrieve the full evolution path and the specific triggers for any species in the database. **How can I find the specific details of a berry by its name?** Use the `get_berry` tool and provide the name (e.g., 'cheri'). The agent will return its growth time, max harvest, size, and smoothness. **Can I list all the different ways a Pokémon can be encountered?** Yes, use the `list_encounter_methods` tool. It provides a paginated list of all methods like 'walk', 'old-rod', or 'surf' used in the games. **Is it possible to check the effects of Pokémon Contests?** Absolutely. You can use `list_contest_effects` to see available effects or `get_contest_effect` with a specific ID to see the detailed appeal and jam metadata.