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