Review Guru MCP Server
<!-- mcp-name: io.github.kapruka/reviewguru -->
An MCP server that exposes Sri Lankan business reviews and doctor profiles from Review Guru to Claude Desktop, Cursor, Cline, or any MCP-aware AI agent.
No API key. No scraping. Calls a public, cached, rate-limited HTTPS endpoint.
What you get
| Tool | What it does |
|---|---|
list_businesses(city?, category?, min_rating?, sort?, limit?) | Ranked list of businesses. Sort: top, most-reviewed, newest. |
get_business(slug) | Full profile: address, phone, hours, categories, rating breakdown, top 10 reviews. |
get_reviews(slug, sort?, limit?) | Paginated reviews. Sort: newest, highest, lowest, helpful. |
search(query, limit?) | Full-text search (FTS5) across every business and doctor. |
list_categories() | Top-level categories + sub-categories with slugs. |
list_cities() | Sri Lankan cities with business counts. |
Plus a reviewguru://about resource that returns live counts.
Data covers restaurants, hotels, shops, salons, hospitals, Sri Lankan doctors with specialty + practice locations, and more — all with patient/ customer reviews.
Install
With uv (recommended)
uvx reviewguru-mcp
With pipx
pipx install reviewguru-mcp
reviewguru-mcp
With pip
pip install reviewguru-mcp
reviewguru-mcp
The server speaks MCP over stdio — invoke it from any MCP client config.
Wire it up
Claude Desktop
Edit ~/Library/Application Support/Claude/claude_desktop_config.json (Mac)
or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"reviewguru": {
"command": "uvx",
"args": ["reviewguru-mcp"]
}
}
}
Restart Claude Desktop. The 🔌 icon in chat will show the Review Guru tools.
Cursor
Settings → MCP → Add new MCP server:
- Command:
uvx - Args:
reviewguru-mcp
Cline (VS Code)
Cline → Settings → MCP Servers → Add:
{
"reviewguru": {
"command": "uvx",
"args": ["reviewguru-mcp"]
}
}
Try it
Once wired up, ask your assistant things like:
Find me three highly-rated cardiologists in Colombo and tell me which hospital each one consults at.
What are people saying about Ministry of Crab? Pull the most recent five reviews.
I'm a vegetarian visiting Galle for a weekend — recommend two restaurants.
The model will pick the right tools and stitch the answers together.
Configuration
Environment variables (all optional):
| Variable | Default | Effect |
|---|---|---|
REVIEWGURU_API | https://reviewguru.lk | API base URL — point at staging or a fork. |
REVIEWGURU_URL | https://reviewguru.lk | Used to render business URLs in tool output. |
DATABASE_URL | (none) | If set to an existing SQLite path, server uses local DB instead of HTTP. Maintainer-only. |
Rate limits + acceptable use
The public API is shared and lightly rate-limited (60 req/min per IP). For
heavier usage, set REVIEWGURU_API to your own deployment.
Reviews are licensed for citation with attribution to Review Guru and a link back to the specific business URL. See reviewguru.lk/llms.txt for full LLM-usage guidelines.
Self-hosting
Want to fork? The server is one Python file (server.py). It auto-detects:
- HTTP mode (default) — calls
/api/v1endpoints. Works anywhere. - SQLite mode — if
data/reviewguru.dbis present in the parent dir. Used by the maintainers for sub-millisecond local queries.
git clone https://github.com/kapruka/reviewguru-mcp
cd reviewguru-mcp
pip install -e .
reviewguru-mcp
Links
- 🌐 Site — https://reviewguru.lk
- 🔌 Public API — https://reviewguru.lk/api/v1
- 📜 OpenAPI spec — https://reviewguru.lk/api/openapi.json
- 📄 LLM usage policy — https://reviewguru.lk/llms.txt
- 🐛 Issues — https://github.com/kapruka/reviewguru-mcp/issues
License
MIT — see LICENSE.