The For Five Coffee MCP Server provides programmatic access to For Five Coffee's menu data through both MCP tools for AI assistants and a REST API for applications.

Access full menu data including all categories and items via the get_full_menu tool or /api/menu endpoint
Search menu items by name, description, or category using the search_menu_items tool or /api/menu/search?q={query} endpoint
Browse categories through the get_menu_categories tool or /api/menu/categories endpoint
Filter by category using the get_items_by_category tool or /api/menu/category/{name} endpoint
Integrate with AI assistants like Claude Desktop and Cursor through MCP protocol for natural language queries
Build web applications using the HTTP API with health checks, server info, and menu operations
Use in multiple programming languages with JavaScript and Python client examples
Handle common issues automatically with SSL fallback mechanisms and error handling

For Five Coffee MCP Server

A Model Context Protocol (MCP) server that provides access to For Five Coffee menu data. Works with Claude Desktop, Cursor, and other MCP clients, plus provides a REST API.

Quick Start

git clone https://github.com/Kong/for-five-mcp.git cd for-five-mcp npm install npm start

This starts both:

MCP Server (stdio) - for AI assistants
HTTP API (port 3000) - for web apps

MCP Client Setup

Claude Desktop

Add to claude_desktop_config.json:

{ "mcpServers": { "for-five-coffee": { "command": "node", "args": ["/path/to/for-five-mcp/server.js"] } } }

Cursor

Option 1: Let Cursor start the server Add to ~/.cursor/mcp.json:

{ "mcpServers": { "for-five-coffee": { "command": "node", "args": ["/path/to/for-five-mcp/server.js"], "env": { "PORT": "3000" } } } }

Option 2: Connect to already running server If you're running npm start separately, add this to ~/.cursor/mcp.json:

{ "mcpServers": { "for-five-coffee": { "url": "http://localhost:3000/mcp", "transport": "http" } } }

This connects Cursor to the running MCP server via HTTP JSON-RPC 2.0 transport.

Usage Examples

Ask Your AI Assistant

"What coffee drinks does For Five Coffee have?"
"Search for pastries on the menu"
"What's the cheapest coffee option?"
"Show me all tea varieties"

Use the HTTP API

# Get full menu curl http://localhost:3000/api/menu # Search for items curl "http://localhost:3000/api/menu/search?q=latte" # Get categories curl http://localhost:3000/api/menu/categories

In Your Code

// Fetch menu data const response = await fetch('http://localhost:3000/api/menu'); const menu = await response.json(); // Search items const search = await fetch('http://localhost:3000/api/menu/search?q=coffee'); const results = await search.json();

import requests # Get menu menu = requests.get('http://localhost:3000/api/menu').json() # Search results = requests.get('http://localhost:3000/api/menu/search', params={'q': 'latte'}).json()

Available Endpoints

Endpoint	Description
`GET /`	Server info
`GET /health`	Health check
`GET /api/menu`	Full menu
`GET /api/menu/search?q={query}`	Search items
`GET /api/menu/categories`	All categories
`GET /api/menu/category/{name}`	Items by category
`POST /mcp`	MCP JSON-RPC 2.0 endpoint

MCP Tools

get_full_menu - Get complete menu
search_menu_items - Search by query
get_menu_categories - List categories
get_items_by_category - Filter by category

Development

npm run dev # Start with auto-restart npm test # Run all tests npm run test:unit # Unit tests only npm run test:http # HTTP API tests only npm run test:mcp # MCP transport tests only npm run test:integration # Integration tests only npm run lint # Check code style

Troubleshooting

MCP not working?

Check the absolute path to server.js in your config
Restart your MCP client after config changes
Run npm start manually to test

HTTP API not responding?

Make sure server is running: npm start
Check port 3000 isn't in use: lsof -i :3000
Test: curl http://localhost:3000/health

No menu data?

Check internet connection
The server handles SSL issues automatically
Website structure may have changed (fallbacks included)

License

Apache 2.0

For Five Coffee MCP Server

For Five Coffee MCP Server

Quick Start

MCP Client Setup

Claude Desktop

Cursor

Usage Examples

Ask Your AI Assistant

Use the HTTP API

In Your Code

Available Endpoints

MCP Tools

Development

Troubleshooting

License

Related Resources

Tools

New MCP Servers

MCP directory API