Untappd Model Context Protocol Server
LocalAbout Untappd Model Context Protocol Server
A Node.js MCP server for querying the Untappd API, with tools for beer search and details. Its user-check-in tool is listed as currently nonfunctional, and new API key registrations are no longer accepted.
Key features
- 01Search Untappd for beers
- 02Get detailed beer information by beer ID
- 03User check-in lookup (currently nonfunctional)
Use cases
- 01Find a beer by search query
- 02Retrieve details for a beer found in search
MCP support
Exposes Untappd API queries as MCP tools for clients, including beer search and beer details.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEUntappd Model Context Protocol Server
This is a simple MCP server written in node to query the Untappd API. Unfortunately they are no longer accepting registrations for new API keys.
Currently only supports 3 tools:
search_beer: This will search Untappd for a beerget_beer_info: This get's the detailed beer info via thebeer_idreturned from a search.get_user_checkins: currently does not work This will return a users checkin's.
Development
Install dependencies:
npm install
Build the server:
npm run build
For development with auto-rebuild:
npm run watch
Installation
To use with Claude Desktop, add the server config:
On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%/Claude/claude_desktop_config.json
{
"mcpServers": {
"untappd-server": {
"command": "/path/to/untappd-server/build/index.js"
}
}
}
Debugging
Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:
npm run inspector
The Inspector will provide a URL to access debugging tools in your browser.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.