heart-jtbd-mcp

An MCP server that exposes the live HEART x JTBD B2B prospect audit as a single agent tool. It is a thin wrapper over the production funnel at https://gtmalpha-advanced.netlify.app and adds no scoring logic of its own. The agent calls one tool; the server runs the full live pipeline (firmographic and technographic enrichment, review platform and live web signal collection, real time web research, and HEART scoring per buying role) and returns the scored result.

What it scores

For a seller selling to a named prospect, it scores five HEART dimensions on a 0 to 100 scale, per buying role:

• Hero-Making, can the champion build an internal business case
• Expert Authority, third party validation and analyst recognition
• Anxiety Reduction, social proof and review strength
• Relationship, existing connection points
• Trust, security, compliance, and credibility signals

It returns an executive summary, a deal briefing with a verdict and pre-call actions, a persona heat map, a competitive delta, and per-role recommendations.

Install

npm install -g @shashwatgtmalpha/heart-jtbd-mcp

Or run without installing:

npx @shashwatgtmalpha/heart-jtbd-mcp

The tool

run_prospect_audit

Inputs:

• sellerCompany (string, required), the selling company name
• sellerDomain (string, optional), e.g. freshworks.com
• prospectCompany (string, required), the target prospect company name
• prospectDomain (string, optional), e.g. bitscale.ai
• region (string, optional), default Global
• buyingRoles (string array, optional), default Champion, Economic Buyer, Technical Evaluator
• email (string, required), the work email that carries the audit credits

The email is the credit identity. The first audit per email is free; further audits draw from a credit pack. The tool runs the real production pipeline end to end and can take two to five minutes. It returns clean structured text plus the raw JSON payload. It handles the insufficient_data and credit_exhausted cases gracefully.

Configuration

The base URL is configurable with the HEART_MCP_BASE environment variable and defaults to https://gtmalpha-advanced.netlify.app.

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "heart-jtbd": {
      "command": "npx",
      "args": ["-y", "@shashwatgtmalpha/heart-jtbd-mcp"]
    }
  }
}

Claude Code

claude mcp add heart-jtbd -- npx -y @shashwatgtmalpha/heart-jtbd-mcp

How it works

The server replicates the exact request shapes and sequence the browser client uses: POST brand-start, poll check-diagnostic for both Apify actors until SUCCEEDED, mint an auditId, POST brand-score-background, then poll brand-result until done, with a staged brand-analyze fallback. No new compute, no new endpoints.

License

MIT