Skip to main content
Glama
SignalGrid B2B Intelligence MCP

SignalGrid B2B Intelligence MCP

README.md
# SignalGrid B2B Intelligence — Open-Source MCP Server (`signalgrid-b2b-mcp`)

Open-source **Model Context Protocol (MCP)** TypeScript server (`@modelcontextprotocol/sdk`) connecting **Claude Desktop**, **Cursor**, **Windsurf**, **Cline**, and MCP clients to pure-HTTP B2B SaaS churn intelligence and US customs port detention datasets powered by [`signalgridhq`](https://apify.com/signalgridhq).

<a href="https://glama.ai/mcp/servers/@kevinduong0101-max/signalgrid-b2b-mcp">
  <img width="380" height="200" src="https://glama.ai/mcp/servers/@kevinduong0101-max/signalgrid-b2b-mcp/badge" alt="signalgrid-b2b-mcp MCP server" />
</a>

---

## Features & Included MCP Primitives

### Tools (`tools/list`)
1. **`extract_xero_b2b_leads_and_churn`** — Extracts 570+ Xero App Store B2B vendor leads, partner websites, 1–5 star histograms, and 1–3 star churning user reviews via [`signalgridhq/xero-app-marketplace-scraper`](https://apify.com/signalgridhq/xero-app-marketplace-scraper).
2. **`extract_quickbooks_b2b_leads_and_churn`** — Extracts 660+ US / 6,400+ global QuickBooks App Store vendor contacts (`supportEmail`, `supportPhone`, partner website), pricing tiers, Intuit AQI quality badges, and 1–3 star churn reviews via [`signalgridhq/quickbooks-app-marketplace-scraper`](https://apify.com/signalgridhq/quickbooks-app-marketplace-scraper).
3. **`extract_fda_port_refusal_leads`** — Extracts official US FDA OASIS port detention & import refusal shipments with foreign manufacturer FEI, street address, private-lab gap flag, and FD&C Act violation charges via [`signalgridhq/fda-import-refusal-leads`](https://apify.com/signalgridhq/fda-import-refusal-leads).
4. **`preview_sample_b2b_dataset`** — Reads up to 50 verified sample records (`xero`, `quickbooks`, or `fda`) locally from `samples/*.csv` **offline with zero API key required**.

### Resources (`resources/list`)
- `signalgrid://samples/xero-apps-50` → [`samples/xero-apps-sample-50.csv`](./samples/xero-apps-sample-50.csv)
- `signalgrid://samples/quickbooks-apps-50` → [`samples/quickbooks-apps-sample-50.csv`](./samples/quickbooks-apps-sample-50.csv)
- `signalgrid://samples/fda-import-refusals-50` → [`samples/fda-import-refusals-sample-50.csv`](./samples/fda-import-refusals-sample-50.csv)

### Prompts (`prompts/list`)
- `find-competitor-churn-leads` — Cross-marketplace Xero vs QuickBooks 1–3 star churn comparison workflow.
- `triage-fda-detained-shipments` — Foreign exporter compliance outreach workflow filtering shipments without private lab analysis.

---

## Quickstart: Self-Hosted `stdio` Server (Node.js or Docker)

### Option A: Build & Run from Source (Node.js >= 20)

```bash
git clone https://github.com/kevinduong0101-max/signalgrid-b2b-mcp.git
cd signalgrid-b2b-mcp
npm install
npm run build
```

Add to `claude_desktop_config.json` or `.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "signalgrid-b2b": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/signalgrid-b2b-mcp/dist/index.js"],
      "env": {
        "APIFY_API_TOKEN": "YOUR_APIFY_API_TOKEN"
      }
    }
  }
}
```

### Option B: Run via Docker

```bash
docker build -t signalgrid-b2b-mcp .
```

```json
{
  "mcpServers": {
    "signalgrid-b2b": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "APIFY_API_TOKEN", "signalgrid-b2b-mcp"],
      "env": {
        "APIFY_API_TOKEN": "YOUR_APIFY_API_TOKEN"
      }
    }
  }
}
```

### Option C: Zero-Install Remote Streamable HTTP Connector

```json
{
  "mcpServers": {
    "signalgrid-b2b-remote": {
      "type": "http",
      "url": "https://mcp.apify.com/?tools=signalgridhq/xero-app-marketplace-scraper,signalgridhq/quickbooks-app-marketplace-scraper,signalgridhq/fda-import-refusal-leads",
      "headers": {
        "Authorization": "Bearer YOUR_APIFY_API_TOKEN"
      }
    }
  }
}
```

---

## Environment Variables

| Variable | Required | Description |
| :--- | :---: | :--- |
| `APIFY_API_TOKEN` | Optional for startup / sample preview; Required for live extraction | Your Apify API token ([free `$5/month` starter credit](https://console.apify.com/settings/integrations)). Server boots, lists tools/resources/prompts, and serves `preview_sample_b2b_dataset` without a token. |

---

## License

MIT — see [LICENSE](./LICENSE).

TDQS

A3.7/5.0

Scored across 4 tools

Disambiguation5/5

Each extraction tool targets a single, explicitly named data source (Xero, QuickBooks, FDA), so there is no realistic chance of misselection. The preview tool is clearly differentiated as an offline sample reader versus the live extraction tools.

Naming Consistency5/5

All four names follow the same snake_case action_target pattern (extract_<source>_<dataset>, preview_sample_b2b_dataset). Verb choice and structure are predictable throughout.

Tool Count4/5

Four tools is lean but coherent for a read-only lead-extraction server: three sources plus a zero-key preview path. It sits at the low end of the ideal range, with no filler tools.

Completeness4/5

The surface covers each advertised dataset with live extraction plus an offline preview, matching the read-only scraping purpose. Minor gaps exist around dataset discovery/metadata and explicit filtering or pagination operations, but agents can work around these via tool parameters.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues