Untappd Model Context Protocol Server

What is Untappd Model Context Protocol Server?

A simple MCP server written in Node.js to query the Untappd API. It provides three tools for searching beers, getting beer details, and retrieving user checkins (currently non‑functional). Intended for use with MCP‑compatible clients like Claude Desktop.

How to use Untappd Model Context Protocol Server?

Install dependencies with npm install, build with npm run build, then add the server configuration to your Claude Desktop config file. Run npm run watch for development with auto‑rebuild or npm run inspector for debugging with MCP Inspector.

Key features of Untappd Model Context Protocol Server

• Searches Untappd for a beer (search_beer)
• Gets detailed beer info by beer ID (get_beer_info)
• Retrieves a user’s checkins (get_user_checkins – currently not working)
• Communicates over stdio via the MCP protocol
• Built for Node.js, easy to integrate with Claude Desktop

Use cases of Untappd Model Context Protocol Server

• Look up a beer by name and get its Untappd details
• Obtain detailed beer information (e.g., ABV, brewery, rating) using a beer ID
• Retrieve a logged‑in user’s recent checkins (once the tool is fixed)

FAQ from Untappd Model Context Protocol Server

Can I still get an Untappd API key?

No. Untappd is no longer accepting registrations for new API keys, so this server can only be used with an existing, valid key.

Why does get_user_checkins not work?

The README states that this tool “currently does not work” and will return a user’s checkins once implemented.

What runtime and dependencies are required?

Node.js is required. Dependencies are installed via npm install.

Where do I configure this server for Claude Desktop?

On macOS, add the server to ~/Library/Application Support/Claude/claude_desktop_config.json. On Windows, use %APPDATA%/Claude/claude_desktop_config.json.

How can I debug the server?

Use the MCP Inspector by running npm run inspector; it provides a URL with debugging tools.