io.github.peterjduffy/parsley-mcp

Official8 tools

by peterjduffy · TypeScript

Parsley - Buyer Intent Signals

Query buyer intent signals, MEDDIC qualifications, and lead scores from Parsley.

Queries buyer intent signals, sales qualifications, and lead scores from Parsley.

Captured live from the server via tools/list.

get_conversations

List recent chatbot conversations with filtering by lead quality, intent signal, and date range.

Parameters (5)

daysnumber
lead_qualitystring
intent_signalstring
limitnumber
clientstring
Agency only: target a managed client org by its id to query that client's data. Omit for your own.

get_conversation_detail

Get full details of a single conversation: MEDDIC signals, engagement metrics, enrichment data, and any owner-configured discovery field values captured during the chat (e.g. company size, current tooling, hiring status).

Parameters (2)

conversation_idstringrequired
clientstring
Agency only: target a managed client org by its id to query that client's data. Omit for your own.

get_hot_leads

Get all hot and warm leads with MEDDIC evidence. The morning briefing tool.

Parameters (3)

daysnumber
include_warmboolean
clientstring
Agency only: target a managed client org by its id to query that client's data. Omit for your own.

get_analytics_summary

Dashboard-level overview: views, conversations, lead counts, conversion rate.

Parameters (2)

daysnumber
clientstring
Agency only: target a managed client org by its id to query that client's data. Omit for your own.

search_by_intent

Find conversations matching specific MEDDIC signals, intent score, or topic.

Parameters (5)

meddic_signalsarray
min_intent_scorenumber
topicstring
daysnumber
clientstring
Agency only: target a managed client org by its id to query that client's data. Omit for your own.

get_knowledge_gaps

Surface unanswered questions from chatbot conversations, grouped by topic.

Parameters (4)

daysnumber
topicstring
limitnumber
clientstring
Agency only: target a managed client org by its id to query that client's data. Omit for your own.

get_lead_enrichment

Get extracted company, role, timeline, and budget context from conversations.

Parameters (3)

daysnumber
has_companyboolean
clientstring
Agency only: target a managed client org by its id to query that client's data. Omit for your own.

get_meddic_summary

Aggregate MEDDIC signal distribution across all conversations.

Parameters (2)

daysnumber
clientstring
Agency only: target a managed client org by its id to query that client's data. Omit for your own.

README.md5 KBView on GitHub

Parsley MCP Server

A Model Context Protocol server that exposes buyer intent signals, MEDDIC qualification data, and lead intelligence from your Parsley account to AI assistants like Claude Desktop and Cursor.

What it does

Ask your AI assistant natural questions about your leads:

"Which leads went hot this week?"
"Show me the MEDDIC gaps for recent conversations"
"Any high-intent visitors that nobody's followed up on?"
"What are people asking that my chatbot can't answer?"

If you also have a CRM MCP connected (Attio, HubSpot, Salesforce, etc.), Claude can cross-reference automatically - finding hot leads with no CRM follow-up, prepping you for calls with full context from both systems.

Setup

1. Get your API key

Generate an API key at parsley.id/hub/api-keys. You need a Parsley account with the chatbot enabled.

2. Configure Claude Desktop

Add to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

json

{
  "mcpServers": {
    "parsley": {
      "command": "npx",
      "args": ["-y", "@tryparsley/mcp-server"],
      "env": {
        "PARSLEY_API_KEY": "pk_live_your_key_here"
      }
    }
  }
}

3. Configure Cursor

Add to your Cursor MCP settings (.cursor/mcp.json):

json

{
  "mcpServers": {
    "parsley": {
      "command": "npx",
      "args": ["-y", "@tryparsley/mcp-server"],
      "env": {
        "PARSLEY_API_KEY": "pk_live_your_key_here"
      }
    }
  }
}

Environment variables

Variable	Required	Description
`PARSLEY_API_KEY`	Yes	Your Parsley API key (`pk_live_...`)
`PARSLEY_BASE_URL`	No	API base URL (defaults to `https://www.parsley.id`)

Tools (8)

Free tier

Tool	Description
`get_analytics_summary`	Dashboard overview - profile views, conversations, lead quality breakdown, top topics, conversion rate

Business tier

Tool	Description
`get_conversations`	List recent conversations with filtering by lead quality, intent signal, date range
`get_conversation_detail`	Full conversation detail - MEDDIC signals with evidence quotes, engagement, enrichment
`get_hot_leads`	Hot and warm leads with MEDDIC evidence - the morning briefing tool
`search_by_intent`	Find conversations by MEDDIC signals, intent score, or topic
`get_knowledge_gaps`	Unanswered chatbot questions grouped by topic and frequency
`get_lead_enrichment`	Extracted company, role, timeline, and budget context from conversations
`get_meddic_summary`	Aggregate MEDDIC signal distribution - per-signal counts, top combinations

Prompts (5)

Predefined workflow templates that appear in Claude's prompt picker.

Prompt	Cross-MCP	Description
`morning_briefing`	Yes	Hot leads summary with follow-up priorities. Cross-references CRM if connected.
`stale_leads_check`	Yes	Qualified leads with no recent CRM activity. Requires a CRM MCP.
`coaching_gaps`	No	MEDDIC gaps with suggested follow-up questions for each lead.
`content_opportunities`	No	Knowledge gaps turned into blog post, chatbot doc, and FAQ suggestions.
`deal_prep`	Optional	Pre-call briefing on a company/person. Pulls CRM context if available.

Cross-MCP workflows

Prompts marked "Cross-MCP" work with any CRM that has an MCP server. Connect both Parsley and your CRM's MCP to Claude, and the prompts will orchestrate across both automatically. No extra configuration needed.

Tested with: Attio, HubSpot, Salesforce, Copper, Pipedrive.

Tier gating

Free plan: get_analytics_summary tool only
Business plan: All 8 tools + all 5 prompts

Upgrade at parsley.id/pricing.

Development

bash

git clone https://github.com/peterjduffy/parsley-mcp.git
cd parsley-mcp
npm install
npm run build
PARSLEY_API_KEY=pk_live_xxx node dist/index.js

License

MIT

Install

Configuration

Environment variables

PARSLEY_API_KEYrequiredsecret

Your Parsley API key (starts with pk_live_). Generate one at parsley.id/hub/api-keys

claude_desktop_config.json

{
  "mcpServers": {
    "parsley-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@tryparsley/mcp-server@0.1.2"
      ],
      "env": {
        "PARSLEY_API_KEY": "<YOUR_PARSLEY_API_KEY>"
      }
    }
  }
}