Summary
Search Untappd's beer database from any AI assistant. Find beers by name, brewery, or style; read beer detail with ratings; look up venues and check-ins. 4 tools, requires free Untappd API client_id + client_secret.
Try asking
Example prompts for Untappd
Click any prompt to copy it. Paste into Claude, ChatGPT, Cursor, Gemini, Copilot or OpenClaw to run it against this connector.
Claude is AI and can make mistakes. Please double-check responses.
Self-hosted only. Untappd refuses requests from datacenter IP addresses, and AnythingMCP Cloud runs in a datacenter, so this connector is not available on AnythingMCP Cloud. It works on an AnythingMCP instance you run yourself on a computer or server with a regular home or office internet connection.
Untappd + Claude
Search Untappd's beer database from any AI assistant. Find beers by name, brewery, or style; read beer detail with ratings; look up venues and check-ins. 4 tools, requires free Untappd API client_id + client_secret.
Prerequisites
See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:
UNTAPPD_CLIENT_ID, UNTAPPD_CLIENT_SECRET
Step 1 — Get credentials
This connector wraps Untappd's REST API (api.untappd.com/v4).
Setup: Untappd requires a free API client_id + client_secret. Apply for them at https://untappd.com/api/register. Approval is usually fast.
Provide:
UNTAPPD_CLIENT_ID— your app's client IDUNTAPPD_CLIENT_SECRET— your app's client secret
What's exposed: public, unauthenticated endpoints (no user OAuth needed for basic search + lookup). For per-user data (your check-ins, your wishlist), you'd need OAuth — not included in this connector.
Rate limits: Untappd publishes 100 req/hour per client. The connector does not auto-retry on 429; respect the limit.
…(continued in the in-app connector instructions)
Step 2 — Install the adapter
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
- Open
http://localhost:3000and register. The first account becomes the admin. - Open the connector store (
http://localhost:3000/connectors/store), pick Untappd, fill in the credentials it asks for (some connectors need none) and install it. - Under MCP Servers, create a server and assign the Untappd connector to it. On the server's page, copy the MCP endpoint (
http://localhost:4000/mcp/<server-id>) and generate a key under API keys.
The quickstart listens on localhost only. For an instance that other people or cloud-based AI clients can reach, clone the repository and run ./setup.sh, which sets up a domain, HTTPS and OAuth (deployment guide).
Step 3 — Add the Untappd connector to Claude
Claude reaches MCP servers in two different ways, and only one of them works with the localhost quickstart.
Claude Code runs on your computer, so it can use the local endpoint directly:
claude mcp add --transport http untappd http://localhost:4000/mcp/<server-id> --header "X-API-Key: <your-api-key>"
Run claude mcp list to check that it connected.
Claude.ai and Claude Desktop add remote servers as custom connectors: go to Customize → Connectors, click + and choose Add custom connector (on Team and Enterprise plans an owner adds it first under Organization settings → Connectors). Claude opens that connection from Anthropic's cloud, not from your computer, so a localhost URL does not work there. You need an AnythingMCP instance with a public HTTPS address (see ./setup.sh above) on a connection Untappd accepts; paste that instance's MCP endpoint and sign in to AnythingMCP when Claude asks.
Available tools
| Tool | What it does |
|---|---|
untappd_search_beer | Search Untappd for beers by free-text query (name, brewery, style) |
untappd_get_beer | Full detail of one beer by ID — brewery, style, ABV, IBU, ratings, recent check-ins, label |
untappd_search_brewery | Search Untappd for breweries by free-text query |
untappd_get_brewery | Full detail of one brewery by ID — location, beer list, social stats |
FAQ
Why isn't Untappd available on AnythingMCP Cloud? Untappd refuses requests from datacenter IP addresses. AnythingMCP Cloud runs in a datacenter, so every call would fail. An AnythingMCP instance on a home or office connection usually works.
Next steps
Was this guide helpful?