@pitchmentor/mcp
OfficialClick on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@@pitchmentor/mcp summarize my latest sales call and list any new leads"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@pitchmentor/mcp
Official Model Context Protocol server (stdio) for the
Pitch Mentor API, built on @pitchmentor/sdk.
It gives AI assistants (Claude Desktop, Claude Code, Cursor, …) one tool per API operation. Node 20+.
API reference: https://pitchmentor.net/docs
Install
No install needed with npx (below). Or install it globally to get the pitchmentor-mcp command:
npm install -g @pitchmentor/mcpRelated MCP server: Ploomes MCP Server
Authentication
The server requires PITCHMENTOR_API_KEY: a team API key (pm_live_…, created in the Pitch Mentor dashboard), sent
as Authorization: Bearer pm_live_…. Use a key with only the scopes you want the assistant to have, e.g. read-only
scopes (calls:read, analytics:read, …) for an analysis assistant. PITCHMENTOR_BASE_URL optionally overrides the
API host.
Claude Desktop
Add to claude_desktop_config.json (Settings → Developer → Edit Config):
{
"mcpServers": {
"pitchmentor": {
"command": "npx",
"args": ["-y", "@pitchmentor/mcp"],
"env": { "PITCHMENTOR_API_KEY": "pm_live_…" }
}
}
}Claude Code
claude mcp add pitchmentor -e PITCHMENTOR_API_KEY=pm_live_… -- npx -y @pitchmentor/mcpOr check it into a project's .mcp.json (keep the key in your environment, not in the file):
{
"mcpServers": {
"pitchmentor": {
"command": "npx",
"args": ["-y", "@pitchmentor/mcp"],
"env": { "PITCHMENTOR_API_KEY": "${PITCHMENTOR_API_KEY}" }
}
}
}Tools
Each API operation (except fetching the OpenAPI document) is a tool named after its operationId in snake_case, with
the operation's parameters as its input schema. For example:
Area | Tools |
Calls |
|
Analytics |
|
Leads |
|
Team |
|
Coaching |
|
Billing & referrals |
|
Webhooks |
|
API keys |
|
Read-only tools carry readOnlyHint. Destructive tools (revoke_api_key, rotate_api_key, delete_webhook_endpoint,
rotate_webhook_secret, remove_member, cancel_invite) carry destructiveHint and a DESTRUCTIVE warning in their
description, so clients ask before running them.
Pagination
List tools return one page (data, has_more, next_cursor); the assistant passes next_cursor as cursor to read on.
Retries, idempotency and errors
Calls go through @pitchmentor/sdk: 429, 5xx and network errors are retried (2 times) honoring retry-after, and every
POST carries an Idempotency-Key reused across retries, so a retried tool call never runs twice. API errors come back as
tool results with isError: true and the API's status, code (e.g. insufficient_scope) and message, so the assistant
can explain or adjust.
Webhooks
The assistant can manage webhook endpoints and deliveries with the tools above. To verify incoming webhook signatures in
your own server, use verifyWebhook from @pitchmentor/sdk.
Development
npm install
npm test # build + node:testTools come from the operations of the published @pitchmentor/sdk, so
bumping that dependency is all it takes to expose new API operations.
Releasing
Bump
versioninpackage.json(scripts/check-version.sh X.Y.Z), merge tomain.git tag vX.Y.Z && git push origin vX.Y.Z. The Release workflow tests, publishes to npm with provenance and creates the GitHub Release.
Support
Docs · Status · Discord. Security issues: see the security policy.
License
Available Tools
41 toolsarchive_callA
Archive a call (hidden from history and analytics, not deleted).
Requires scope calls:write.
Inputs: id (required).
batch_upsert_leadsA
Import up to 100 leads (upsert on externalId; omitted fields are cleared on update).
Requires scope leads:write.
Inputs: leads (required).
cancel_inviteBDestructiveIdempotent
Cancel a pending invite.
DESTRUCTIVE: this cannot be undone. Only call it when the user explicitly asked for exactly this action.
Requires scope team:write.
DESTRUCTIVE: cannot be undone.
Inputs: id (required).
create_api_keyA
Create an API key (the key is returned once).
The result contains a secret that is shown only once; show it to the user and do not repeat it elsewhere.
Requires scope api_keys:write.
Inputs: name (required), scopes (required), expiresAt.
create_coaching_styleB
Create a custom coaching style (Premium/Enterprise).
Requires scope coaching:write.
Inputs: name (required), personalityPrompt (required), description, objectionStyle, +2 more.
create_inviteA
Create an invite link (counts against the seat limit).
Requires scope team:write.
Inputs: no named parameters.
create_webhook_endpointA
Add a webhook endpoint (the signing secret is returned once).
The result contains a secret that is shown only once; show it to the user and do not repeat it elsewhere.
Requires scope webhooks:write.
Inputs: url (required), events (required), description.
delete_webhook_endpointADestructiveIdempotent
Delete a webhook endpoint and its delivery log.
DESTRUCTIVE: this cannot be undone. Only call it when the user explicitly asked for exactly this action.
Requires scope webhooks:write.
DESTRUCTIVE: cannot be undone.
Inputs: id (required).
export_callsBRead-onlyIdempotent
Export calls as CSV or JSON.
Requires scope calls:read.
Inputs: to, from, limit, format, +2 more.
get_analytics_by_memberCRead-onlyIdempotent
Per-member call stats.
Requires scope analytics:read.
Inputs: tz, date, period.
get_analytics_overviewCRead-onlyIdempotent
Team call analytics.
Requires scope analytics:read.
Inputs: tz, date, period, user_id.
get_billing_statusBRead-onlyIdempotent
Plan and subscription status.
Requires scope billing:read.
Inputs: no named parameters.
get_callARead-onlyIdempotent
Get a call with transcript and coaching log.
Requires scope calls:read.
Inputs: id (required).
get_leadCRead-onlyIdempotent
Get a lead.
Requires scope leads:read.
Inputs: id (required).
get_meCRead-onlyIdempotent
The team and API key making the request.
Inputs: no named parameters.
get_referral_statsBRead-onlyIdempotent
Referral link and stats.
Requires scope referrals:read.
Inputs: no named parameters.
get_team_configBRead-onlyIdempotent
Team settings and coaching context.
Requires scope team:read.
Inputs: no named parameters.
get_usageARead-onlyIdempotent
Token and seat usage for the current period.
Requires scope billing:read.
Inputs: no named parameters.
get_webhook_endpointBRead-onlyIdempotent
Get a webhook endpoint.
Requires scope webhooks:read.
Inputs: id (required).
list_api_keysARead-onlyIdempotent
List API keys (including revoked).
Paginated: pass cursor = next_cursor from the previous result to get more.
Requires scope api_keys:read.
Inputs: limit, cursor.
list_callsARead-onlyIdempotent
List calls (newest first).
Paginated: pass cursor = next_cursor from the previous result to get more.
Requires scope calls:read.
Inputs: to, from, limit, cursor, +3 more.
list_coaching_stylesBRead-onlyIdempotent
Built-in and team coaching styles.
Requires scope coaching:read.
Inputs: no named parameters.
list_invitesARead-onlyIdempotent
List pending invites.
Requires scope team:read.
Inputs: no named parameters.
list_leadsARead-onlyIdempotent
List leads (newest first).
Paginated: pass cursor = next_cursor from the previous result to get more.
Requires scope leads:read.
Inputs: limit, stage, cursor, search, +1 more.
list_membersARead-onlyIdempotent
List team members.
Requires scope team:read.
Inputs: no named parameters.
list_member_usageBRead-onlyIdempotent
Per-member usage for the current period.
Requires scope billing:read.
Inputs: no named parameters.
list_webhook_deliveriesARead-onlyIdempotent
Delivery log for an endpoint (newest first).
Paginated: pass cursor = next_cursor from the previous result to get more.
Requires scope webhooks:read.
Inputs: id (required), limit, cursor, status.
list_webhook_endpointsARead-onlyIdempotent
List webhook endpoints.
Paginated: pass cursor = next_cursor from the previous result to get more.
Requires scope webhooks:read.
Inputs: limit, cursor.
remove_memberADestructiveIdempotent
Remove a member from the team.
DESTRUCTIVE: this cannot be undone. Only call it when the user explicitly asked for exactly this action.
The member keeps their account and calls; managers can't be removed via the API.
Requires scope team:write.
DESTRUCTIVE: cannot be undone.
Inputs: id (required).
replay_webhook_deliveryB
Queue the same message again (same webhook-id, new delivery record).
Requires scope webhooks:write.
Inputs: id (required), deliveryId (required).
revoke_api_keyADestructive
Revoke an API key.
DESTRUCTIVE: this cannot be undone. Only call it when the user explicitly asked for exactly this action.
Requires scope api_keys:write.
DESTRUCTIVE: cannot be undone.
Inputs: id (required).
rotate_api_keyADestructive
Replace the key's secret (the old secret stops working immediately).
DESTRUCTIVE: this cannot be undone. Only call it when the user explicitly asked for exactly this action.
Requires scope api_keys:write.
DESTRUCTIVE: cannot be undone.
Inputs: id (required).
rotate_webhook_secretADestructive
Replace the signing secret (returned once; takes effect immediately).
DESTRUCTIVE: this cannot be undone. Only call it when the user explicitly asked for exactly this action.
The result contains a secret that is shown only once; show it to the user and do not repeat it elsewhere.
Requires scope webhooks:write.
DESTRUCTIVE: cannot be undone.
Inputs: id (required).
summarize_callA
Generate (or return the existing) AI summary.
Generating a new summary uses the team's token quota.
Requires scope calls:write.
Inputs: id (required).
test_webhook_endpointA
Send a signed webhook.test event now and return the delivery result.
Requires scope webhooks:write.
Inputs: id (required).
unarchive_callB
Restore an archived call.
Requires scope calls:write.
Inputs: id (required).
update_coaching_styleBIdempotent
Update a custom coaching style.
Requires scope coaching:write.
Inputs: id (required), name, description, objectionStyle, +3 more.
update_leadBIdempotent
Update a lead (only provided fields change).
Requires scope leads:write.
Inputs: id (required), name, email, notes, +8 more.
update_team_configCIdempotent
Update team settings.
Requires scope team:write.
Inputs: name, industry, setGoals, crmBaseUrl, +15 more.
update_webhook_endpointCIdempotent
Update, disable or re-enable a webhook endpoint.
Requires scope webhooks:write.
Inputs: id (required), url, active, events, +1 more.
upsert_leadB
Create a lead, or update the one with the same externalId.
Requires scope leads:write.
Inputs: name (required), email, notes, phone, +7 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 41 tools
Most tools map to a single resource+action, and descriptions clearly separate similar operations (get_call vs summarize_call, get_webhook_endpoint vs test_webhook_endpoint). Some boundaries blur within analytics/usage (get_analytics_overview, get_analytics_by_member, get_usage, list_member_usage) and lead writing (upsert_lead vs update_lead vs batch_upsert_leads), but scope labels and descriptions help an agent choose correctly.
Every tool follows a strict verb_noun snake_case pattern (list_leads, get_call, create_api_key, rotate_webhook_secret). Voice and noun phrasing are consistent across all domains, making names highly predictable.
41 tools is heavy, though the server covers many distinct domains (calls, leads, webhooks, team, billing, coaching, API keys, analytics). Each tool generally earns its place, but the surface is large enough that it approaches the limit of comfortable scoping for an agent.
Core lifecycle coverage is strong for webhooks, API keys, team/invites, and leads. Minor gaps exist: no delete operation for leads, calls, or custom coaching styles (only archive for calls), and analytics is limited to overview and per-member without time-series granularity.
Maintenance
Related MCP Connectors
AI-callable tools for API mocking, testing, monitoring, security, and automation.
Connect your AI agent to 300+ methods and 100+ live tools
Verified, pay-per-use API tools for AI agents through one authenticated connection.
Lets AI agents analyze API metrics, request logs, and traces, and manage apps and alerts.
Related MCP Servers
- AlicenseAqualityDmaintenanceConnects AI agents to the Ploomes CRM REST API, exposing 56 tools for managing contacts, deals, tasks, pipelines, interactions, quotes, orders, products, fields, users, and account information.5617 npm1MIT
- FlicenseCqualityCmaintenanceExposes 153 tools to connect AI assistants to the Ploomes CRM, enabling CRUD operations, funnel configuration, CPQ, automations, and webhooks.1001-
- FlicenseNot gradedqualityDmaintenanceConnects AI assistants to the Ploomes CRM, exposing 153 tools for CRUD operations on entities, pipeline and field configuration, CPQ proposal models, automations, and webhooks.-
- AlicenseCqualityDmaintenanceProvides AI assistants with access to all public GoHighLevel API endpoints as MCP tools, enabling contact, conversation, opportunity, calendar, and other CRM operations with configurable safety gates for writes and deletes.552MIT