How to Use the Amiibo MCP in LangChain

Q: How can I build a LangChain agent to find all card-type Amiibo from the Animal Crossing series?

You'd have your LangChain agent call the listamiibos tool with two filters: amiiboSeries='Animal Crossing' and type='Card'. The agent can reason that it needs to combine those two pieces of information to get you the correct list.

Q: How often is the Amiibo database updated? Can my agent check this?

Yes, your agent can check for updates. The getlastupdated tool returns a timestamp of the last time the entire database was modified. You can build logic for your agent to check this before running a large query.

Build LangChain agents that query the entire Amiibo database. Find figures, check series, and build complex collector workflows.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Amiibo MCP to LangChain

Create your Vinkius account to connect Amiibo to LangChain and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Amiibo with LangChain

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Chain Amiibo Lookups Together

This server's tools let you build multi-step chains. Your agent can call `list_amiibo_series` to get a list of all available series, then feed one of those results directly into `list_amiibos` to get every figure in that specific collection. It's how you connect discrete tasks into a single, logical agent. Because it's LangChain, you get full observability with LangSmith. You can see the exact moment your agent decided to use the output of `list_characters` as a filter for another tool. It makes debugging complex chains way easier because you're not guessing what the agent was thinking.

Build Agents That Reason About Data

A ReAct agent using these tools can make decisions. It might call `get_last_updated` first to decide if the Amiibo data is fresh enough for its task. If a search for a character returns multiple versions, the agent can decide to loop through them with `get_amiibo` to compare release dates and find the right one. This isn't just a simple script. You pass the tools from this MCP Server to LangChain's `create_agent` function, and it handles the hard part. The agent itself figures out which tool to use—and in what order—to answer a user's question about their collection.

Filter and Find Specific Figures

The `list_amiibos` tool becomes much more powerful in a LangChain agent. Your agent can intelligently construct a filter based on a vague user request. Someone might ask for 'all the Link figures that aren't from Smash Bros,' and the agent knows to combine `character='Link'` with a filter to exclude the Super Smash Bros. series. Your agent can also clarify things. If a user asks for Amiibo from 'that Zelda game,' the agent can use `list_game_series` to ask for clarification before building a precise `list_amiibos` query. It turns a simple data fetch into an interactive conversation.

Setup guide

Set up Amiibo MCP in LangChain

Prerequisites

Python 3.10+ installed
langchain-mcp-adapters + langgraph packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run pip install langchain-mcp-adapters langgraph langchain-openai. The MCP adapters package converts MCP tools into native LangChain BaseTool objects.
2

Connect via HTTP transport
Use MultiServerMCPClient with "transport": "http" pointing to your Vinkius endpoint. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Create a ReAct agent
Pass the discovered tools to create_react_agent() from LangGraph. The agent automatically routes Amiibo tool calls through the MCP protocol.
4

Run with any LLM
Swap ChatOpenAI for ChatAnthropic, ChatGoogleGenerativeAI, or any LangChain-compatible model. The MCP tools work identically across all providers.

agent.py

from langchain_mcp_adapters.client import MultiServerMCPClient
from langgraph.prebuilt import create_react_agent
from langchain_openai import ChatOpenAI

async with MultiServerMCPClient({
    "amiibo-mcp": {
        "transport": "http",
        "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
    }
}) as client:
    tools = client.get_tools()

    agent = create_react_agent(
        ChatOpenAI(model="gpt-4o"),
        tools,
    )
    result = await agent.ainvoke({
        "messages": "List recent Amiibo transactions"
    })
    print(result["messages"][-1].content)

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by AmiiboAPI. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Amiibo now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Amiibo MCP in LangChain

You'd have your LangChain agent call the `list_amiibos` tool with two filters: `amiiboSeries='Animal Crossing'` and `type='Card'`. The agent can reason that it needs to combine those two pieces of information to get you the correct list.

Yes. You'd provide your agent with a list of the Amiibo you own. The agent would then call `list_amiibos` with `amiiboSeries='Super Smash Bros.'` and compare that master list against your list to find the ones you're missing.

The most direct way is to have your LangChain agent call the `list_characters` tool. This tool is designed specifically for that purpose and returns a complete list of all characters represented in the Amiibo database.

Yes, your agent can check for updates. The `get_last_updated` tool returns a timestamp of the last time the entire database was modified. You can build logic for your agent to check this before running a large query.

This server only interacts with public Amiibo data: names, series, types, and release dates. No private information is ever requested or stored. All requests from your LangChain agent run in an ephemeral, sandboxed environment on Vinkius, and the connection is secured by your personal endpoint token.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript