Untappd Model Context Protocol Server
Untappd Model Context Protocol Server
Overview
The Untappd Model Context Protocol Server is a simple server written in Node.js that allows users to query the Untappd API for beer-related information.
To use the server, install the dependencies, build the server, and configure it with Claude Desktop. You can search for beers, get detailed beer information, and check user check-ins (though the latter is currently not functional).
- Search for beers using the Untappd API. - Retrieve detailed information about a specific beer using its beer ID. - User check-ins feature (currently not operational).
- Finding specific beers and their details.
- Integrating beer search functionality into applications.
- Debugging and testing beer-related queries using the MCP Inspector.
Add to your AI client
Use these steps to connect Untappd Model Context Protocol Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.
Cursor
Add this to your .cursor/mcp.json file in your project root, then restart Cursor.
.cursor/mcp.json
{
"mcpServers": {
"mcp-untappd-server-jtucker": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-untappd-server-jtucker"
]
}
}
}Claude Desktop
Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
{
"mcpServers": {
"mcp-untappd-server-jtucker": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-untappd-server-jtucker"
]
}
}
}Claude Code
Add this to your project's .mcp.json file. Claude Code will detect it automatically.
.mcp.json (project root)
{
"mcpServers": {
"mcp-untappd-server-jtucker": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-untappd-server-jtucker"
]
}
}
}VS Code (Copilot)
Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.
.vscode/mcp.json
{
"servers": {
"mcp-untappd-server-jtucker": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-untappd-server-jtucker"
]
}
}
}Windsurf
Add this to your Windsurf MCP config file, then restart Windsurf.
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp-untappd-server-jtucker": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-untappd-server-jtucker"
]
}
}
}Cline
Open Cline settings, navigate to MCP Servers, and add this server configuration.
Cline MCP Settings (via UI)
{
"mcpServers": {
"mcp-untappd-server-jtucker": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-untappd-server-jtucker"
]
}
}
}FAQ
Can I register for a new API key?
No, Untappd is no longer accepting registrations for new API keys.
What tools does the server support?
The server currently supports searching for beers and retrieving beer information, but the user check-ins feature is not working at the moment.
How do I debug the server?
You can use the MCP Inspector for debugging, which provides a URL to access debugging tools in your browser.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":1948,"uuid":"d014b4f6-535e-4321-a484-fd5917560887","name":"mcp-untappd-server","title":"Untappd Model Context Protocol Server","description":"Untappd Model Context Protocol Server","avatar_url":"https://avatars.githubusercontent.com/u/264070?v=4","created_at":"$D2025-03-05T07:29:02.154Z","updated_at":"$D2025-03-12T10:21:41.466Z","status":"created","author_name":"jtucker","author_avatar_url":"https://avatars.githubusercontent.com/u/264070?v=4","tags":"mcp-server,modelcontextprotocol","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/jtucker/mcp-untappd-server","target":"_self","content":"$29","summary":"$2a","img_url":null,"type":null,"metadata":"{\"star\":\"0\",\"license\":\"\",\"language\":\"JavaScript\",\"is_official\":false,\"latest_commit_time\":\"2025-02-27 16:27:26\"}","user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]