How to Use the Untappd MCP in OpenAI Agents SDK

Q: How do I find out about beer trends using Untappd and OpenAI Agents SDK?

The gettrendingbeers tool returns both macro and micro trending beers globally. Your agent calls this, and you get a list of what's hot right now on Untappd.

Q: Can I see my friend's recent activity with Untappd and OpenAI Agents SDK?

Yep. You can use getfriendactivity to pull up the specific check-in feed for a selected user. This keeps your agent updated on what your friends are drinking.

Q: What kind of data can I pull about breweries using Untappd and OpenAI Agents SDK?

You can run getbreweryinfo to get detailed facts on any brewery. The agent also lets you see the activity feed for a whole spot with getbreweryactivity.

Q: How do I manage my personal Untappd wish list using OpenAI Agents SDK?

The tool getuserwishlist pulls up everything you've saved. You can also use addtowishlist or removefromwishlist to keep it accurate.

Track your drinking history and social activity using the OpenAI Agents SDK.

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 OpenAI Agents SDK

Create your Vinkius account to connect Untappd to OpenAI Agents SDK 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 OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Manage Friends and Social Connections with Untappd

You can handle friend requests right from your agent. Need to accept or reject a request? Use `accept_friend` or `reject_friend`. You'll also get the full picture of who you know by checking `get_user_friends`. This MCP Server lets your AI client manage your entire social profile. Want to send a friend request? Just call `request_friend` and keep your Untappd connections smooth.

Get Detailed Beer Information via the MCP Server

Want to know everything about a specific beer? The tool `get_beer_info` gives you all the deep details. You can also search for new options using `search_beer`. It's not just basic data, either. You can even check out activity surrounding a single brew with `get_beer_activity`. This helps your agent provide context when talking about Untappd.

Update Your Social Feed and Check-ins using the OpenAI Agents SDK

You don't have to manually log everything. Use `add_checkin` to record a beer you just had, or call `toggle_toast` if you want to make it an Untoast. You can even leave your mark with `add_comment`. If you need to track what others are doing, use `get_notifications`. This gives you the latest feed of news and comments from your Untappd friends.

Setup guide

Set up Untappd MCP in OpenAI Agents SDK

Prerequisites

Python 3.10+ installed
openai-agents package (pip install openai-agents)
Active Vinkius subscription with a valid endpoint token

1

Install the SDK

Run pip install openai-agents to install the OpenAI Agents SDK. The MCP integration is built-in — no extra dependencies needed.
2

Connect via SSE transport

Use MCPServerSse with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. The SDK auto-discovers all Untappd tools at runtime.
3

Create your Agent

Pass the MCP to Agent(mcp_servers=[server]). The agent receives Untappd tools as native definitions — JSON schemas resolve automatically.
4

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate Untappd tools and returns structured results. Copy the full example on the right to get started.

agent.py

import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerSse

async def main():
    async with MCPServerSse(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as server:
        agent = Agent(
            name="Untappd Agent",
            instructions="You have access to Untappd tools.",
            mcp_servers=[server],
        )
        result = await Runner.run(agent, "List recent transactions")
        print(result.final_output)

asyncio.run(main())

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 OpenAI Agents SDK

The `get_trending_beers` tool returns both macro and micro trending beers globally. Your agent calls this, and you get a list of what's hot right now on Untappd.

Yep. You can use `get_friend_activity` to pull up the specific check-in feed for a selected user. This keeps your agent updated on what your friends are drinking.

Yes, when managing friend requests or viewing activity feeds, the MCP Server only touches your profile information and associated social actions. It doesn't access anything outside of the defined tools.

You can run `get_brewery_info` to get detailed facts on any brewery. The agent also lets you see the activity feed for a whole spot with `get_brewery_activity`.

The tool `get_user_wishlist` pulls up everything you've saved. You can also use `add_to_wishlist` or `remove_from_wishlist` to keep it accurate.

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