How to Use the Untappd MCP in Pydantic AI

Q: How do I find out about brewery activity using Untappd and Pydantic AI?

You can use getbreweryactivity to view the feed for any specific brewery. The MCP Server makes sure that all returned data fields are correct and predictable.

Q: Can I check a user's distinct beer history using Untappd and Pydantic AI?

Yes, getuserdistinctbeers returns a complete list of every unique beer a user has logged. This is great for tracking long-term drinking habits.

Q: What tools can I use to modify my Untappd profile using Pydantic AI?

You've got options like removefriend, addtowishlist, and removefromwishlist. These actions keep your local data perfectly synced.

Q: How do I get details on a specific check-in using Untappd and Pydantic AI?

The tool getcheckindetails provides extended information, including the location, any comments left, and toasts. This gives you a full picture of that moment.

Build reliable beer trackers and social agents using Pydantic AI.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Untappd MCP to Pydantic AI

Create your Vinkius account to connect Untappd to Pydantic AI 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 Untappd with Pydantic AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Manage Beer Records with the MCP Server

Keep track of your favorite brews. Use `get_beer_info` to pull detailed data on any Untappd beer. You can also use `search_brewery` to find new sources, and then get more facts using `get_brewery_info`. Every response from this MCP Server is type-validated, so when your agent gets beer data, you know it's correct.

Maintain Your Social Connections via Untappd and Pydantic AI

Handling friends? The agent makes that easy. Use `get_pending_friends` to review requests, then call `accept_friend` or `reject_friend`. You can also see who you know by calling `get_user_friends`. It keeps your social profile accurate and reliable.

Update and Review Activity Feeds with Pydantic AI

Want to log a beer? Use `add_checkin`. To review what others are up to, call `get_user_activity` or `get_notifications`. You can even remove content using `remove_comment`. These tools let your agent keep you in the loop on everything happening on Untappd.

Setup guide

Set up Untappd MCP in Pydantic AI

Prerequisites

Python 3.10+ installed
pydantic-ai-slim[fastmcp] package
Active Vinkius subscription with a valid endpoint token

1

Install Pydantic AI with FastMCP
Run pip install "pydantic-ai-slim[fastmcp]". The FastMCP toolset replaces the deprecated MCPServerHTTP class with full protocol support.
2

Configure the FastMCPToolset
Pass a JSON-style config dict to FastMCPToolset with your Vinkius URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. Supports Streamable HTTP, SSE, and Stdio transports.
3

Create and run your agent
Pass the toolset to Agent(toolsets=[toolset]) and call agent.run(). Swap openai:gpt-4o for any supported model — Anthropic, Google, Mistral, or Groq.

agent.py

from pydantic_ai import Agent
from pydantic_ai.toolsets.fastmcp import FastMCPToolset

toolset = FastMCPToolset({
    "mcpServers": {
        "untappd-mcp": {
            "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
        }
    }
})

agent = Agent(
    "openai:gpt-4o",
    toolsets=[toolset],
    system_prompt="You have access to Untappd tools.",
)

result = await agent.run("List recent Untappd transactions")
print(result.output)

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 Untappd. 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 Untappd 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 Untappd MCP in Pydantic AI

You can use `get_brewery_activity` to view the feed for any specific brewery. The MCP Server makes sure that all returned data fields are correct and predictable.

Yes, `get_user_distinct_beers` returns a complete list of every unique beer a user has logged. This is great for tracking long-term drinking habits.

This server touches your check-in history, friend connections, and personal profile data. All responses are validated against strict Pydantic models so you never get corrupted info.

You've got options like `remove_friend`, `add_to_wishlist`, and `remove_from_wishlist`. These actions keep your local data perfectly synced.

The tool `get_checkin_details` provides extended information, including the location, any comments left, and toasts. This gives you a full picture of that moment.

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