🤖 AsyncPraiseRebuke MCP Server

by fabianwilliams

299 downloads
Not rated
GitHub

About

MCP Server to get access to Reviews that are posted using the Async Praise Rebuke App

Details

Author
fabianwilliams
Downloads
299
Categories
Other

- Lists and searches all public customer feedback reviews
- Views top‑rated and lowest‑rated businesses
- Discovers business contact emails via scraping and heuristics
- Logs new business entries to a Cosmos DB directory
- Automates multi‑step email discovery with an AI agent tool
- Works with any MCP‑compatible client like Claude Desktop

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name 🤖 AsyncPraiseRebuke MCP Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install the package globally with npm install -g @fabianwilliams/asyncpraiserebuke-mcp. Then configure it in Claude Desktop by adding the ClicknContactScannerAgent entry to your config, setting REVIEW_API_KEY and REVIEW_API_BASE_URL environment variables. Alternatively, run the CLI agent directly with npx --yes @fabianwilliams/asyncpraiserebuke-mcp scanAndLogNewBusinessEmails.

listPublicReviews

Get all available public feedback reviews

getTopRatedLocations

Return top and lowest rated feedback locations

searchReviews

Search for reviews by partial or full business name

searchBusinessDirectory

Search for a business email by establishment name

logBusinessEmail

Submit a new business email discovered by an agent or a user

discoverAndLogBusinessEmail

Discover contact emails via ClicknContact and log new entries to the directory

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "\ud83e\udd16 asyncpraiserebuke mcp server": {
            "asyncpraiserebuke-mcp": {
                "command": "npx",
                "args": [
                    "--yes",
                    "@fabianwilliams/asyncpraiserebuke-mcp",
                    "scanAndLogNewBusinessEmails"
                ]
            }
        }
    }
}

McpServers

{
    "asyncpraiserebuke-mcp": {
        "command": "npx",
        "args": [
            "--yes",
            "@fabianwilliams/asyncpraiserebuke-mcp",
            "scanAndLogNewBusinessEmails"
        ]
    }
}

🤖 AsyncPraiseRebuke MCP Server

AsyncPraiseRebuke-MCP is a Model Context Protocol (MCP) server that exposes business feedback and contact discovery tools — including AI agent-based flows — for integration with Claude Desktop or any other MCP-compliant client.

🔍 What It Does

This server powers tools that can:

- ✅ List and search customer feedback reviews
- ✅ View top-rated and lowest-rated establishments
- ✅ Discover business contact emails using scraping and heuristics
- ✅ Log new entries to a Cosmos DB-based directory
- ✅ Chain tool logic with agents that automate multi-step flows

🧩 Available Tools

Core Tools (Stateless & Reusable)

These can be used individually for focused functionality:

- \listPublicReviews\ – Get all public feedback entries
- \getTopRatedLocations\ – View top and bottom rated businesses
- \searchReviews\ – Search reviews by partial business name
- \searchBusinessDirectory\ – Look up existing business entries in Cosmos DB
- \logBusinessEmail\ – Add a business contact email manually
- \discoverBusinessEmail\ (from ClicknContact) – Discover emails and form fields from business websites

🧠 Agent Tool: \discoverAndLogBusinessEmail\

This agentized tool automates the entire workflow:

1. Calls ClicknContact to discover contact info
2. Checks your Cosmos DB directory to prevent duplicates
3. Logs new businesses with placeholder values if needed

Tool name: \discoverAndLogBusinessEmail\
Source: \ClicknContactScannerAgent\

---

🚀 Getting Started

npm install -g @fabianwilliams/asyncpraiserebuke-mcp

Then add to your Claude Desktop config:

"ClicknContactScannerAgent": {
  "command": "npx",
  "args": [
    "--yes",
    "@fabianwilliams/asyncpraiserebuke-mcp",
    "scanAndLogNewBusinessEmails"
  ],
  "env": {
    "REVIEW_API_KEY": "your-key-here",
    "REVIEW_API_BASE_URL": "https://your-api.com/api"
  }
}

You can also run this manually:

npx --yes @fabianwilliams/asyncpraiserebuke-mcp scanAndLogNewBusinessEmails

---

🛠 Dev Structure

/src
  apiClient.ts       // Cosmos-backed endpoint calls
  main.ts            // MCP tool definitions
  types.ts           // Shared types
  scanAndLogNewBusinessEmails.ts // CLI agent wrapper

/test
businessesToScan.json // Sample test data

---

🧪 Testing the Agent

Make sure dependencies are installed and build the project:

npm install
npm run build

Then run:

npx @fabianwilliams/asyncpraiserebuke-mcp scanAndLogNewBusinessEmails

Or test via Claude Desktop:

> Please scan the following websites for contact emails and log any new ones not already in the directory: https://example1.com, https://example2.com

---

📦 Publishing

For maintainers:

npm version patch  # or minor / major
npm publish --access public

---

🪪 License

MIT — use it, fork it, agentify it.

> Built with ❤️ by @fabianwilliams

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.