MCP
Tool reference
9 read-only tools exposed at https://harborchasereviews.com/mcp. Call any of them with a JSON-RPC tools/call request.
get_business
Returns identity, contact info, hours, service areas, and aggregate rating for the business.
Parameters
No parameters.
Returns
Business metadata + aggregate rating + total review count.
Example request
{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_business","arguments":{}}}search_reviews
Searches reviews. Filter by rating, min_rating, since/until date, keyword query, mentions_technician, or mentions_service. limit defaults to 20 (max 100).
Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
rating | number (1-5) | No | Exact star rating to match. | 5 |
min_rating | number (1-5) | No | Minimum star rating (inclusive). | 4 |
since | ISO date | No | Only reviews on or after this date. | 2026-01-01 |
until | ISO date | No | Only reviews on or before this date. | 2026-03-01 |
query | string | No | Substring search within review text. | punctual |
mentions_technician | string | No | Only reviews mentioning the named technician. | Gazi |
mentions_service | string | No | Only reviews mentioning the given service id/label. | ac-repair |
limit | number (1-100) | No | Maximum number of reviews to return (default 20). | 10 |
Returns
{ matched, returned, reviews[] }
Example request
{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_reviews","arguments":{"rating":5,"limit":3}}}get_aspect_sentiment
Returns sentiment analysis for one aspect of customer experience (e.g. punctuality, pricing, technical_knowledge): mention count, sentiment percentages, top phrases.
Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
aspect | string | Yes | Aspect id or label. | punctuality |
Returns
AspectInsight (mention_count, positive_pct, top_phrases, example_review_ids).
Example request
{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_aspect_sentiment","arguments":{"aspect":"punctuality"}}}get_technician
Returns the review summary for a named technician, including every review mentioning them.
Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
name | string | Yes | Technician name or id. | Gazi |
Returns
Technician (mention_count, positive_pct, average_rating_when_mentioned) + reviews[].
Example request
{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_technician","arguments":{"name":"Gazi"}}}get_topic_reviews
Returns reviews and analysis for a service topic (e.g. ac-installation, maintenance, emergency-service).
Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
topic | string | Yes | Topic id or label. | ac-repair |
Returns
Topic (review_count, positive_pct, key_findings) + reviews[].
Example request
{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_topic_reviews","arguments":{"topic":"ac-repair"}}}get_summary
Returns the editorial summary of customer reviews — a paragraph-length synthesis suitable for direct quotation — plus aggregate stats.
Parameters
No parameters.
Returns
{ summary, pull_quote, aggregate_rating, review_count, overall_sentiment }.
Example request
{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_summary","arguments":{}}}list_aspects
Lists available aspect ids with counts (use with get_aspect_sentiment).
Parameters
No parameters.
Returns
[{ id, label, mention_count, positive_pct }]
Example request
{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_aspects","arguments":{}}}list_topics
Lists available topic ids with counts (use with get_topic_reviews).
Parameters
No parameters.
Returns
[{ id, label, review_count, positive_pct }]
Example request
{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_topics","arguments":{}}}list_technicians
Lists technicians named in reviews with counts (use with get_technician).
Parameters
No parameters.
Returns
[{ id, display_name, mention_count, positive_pct }]
Example request
{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_technicians","arguments":{}}}