Skip to main content
Glama
@pitchmentor/mcp

@pitchmentor/mcp

Official
by pitchmentor

@pitchmentor/mcp

npm CI MIT

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/mcp

Related 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/mcp

Or 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

list_calls, get_call, export_calls, summarize_call, archive_call, unarchive_call

Analytics

get_analytics_overview, get_analytics_by_member

Leads

list_leads, get_lead, upsert_lead, batch_upsert_leads, update_lead

Team

get_me, get_team_config, update_team_config, list_members, remove_member, list_invites, create_invite, cancel_invite

Coaching

list_coaching_styles, create_coaching_style, update_coaching_style

Billing & referrals

get_billing_status, get_usage, list_member_usage, get_referral_stats

Webhooks

list_webhook_endpoints, get_webhook_endpoint, create_webhook_endpoint, update_webhook_endpoint, delete_webhook_endpoint, rotate_webhook_secret, test_webhook_endpoint, list_webhook_deliveries, replay_webhook_delivery

API keys

list_api_keys, create_api_key, rotate_api_key, revoke_api_key

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:test

Tools come from the operations of the published @pitchmentor/sdk, so bumping that dependency is all it takes to expose new API operations.

Releasing

  1. Bump version in package.json (scripts/check-version.sh X.Y.Z), merge to main.

  2. 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

MIT

Available Tools

41 tools
archive_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_inviteB
DestructiveIdempotent

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_endpointA
DestructiveIdempotent

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_callsB
Read-onlyIdempotent

Export calls as CSV or JSON.

Requires scope calls:read.

Inputs: to, from, limit, format, +2 more.

get_analytics_by_memberC
Read-onlyIdempotent

Per-member call stats.

Requires scope analytics:read.

Inputs: tz, date, period.

get_analytics_overviewC
Read-onlyIdempotent

Team call analytics.

Requires scope analytics:read.

Inputs: tz, date, period, user_id.

get_billing_statusB
Read-onlyIdempotent

Plan and subscription status.

Requires scope billing:read.

Inputs: no named parameters.

get_callA
Read-onlyIdempotent

Get a call with transcript and coaching log.

Requires scope calls:read.

Inputs: id (required).

get_leadC
Read-onlyIdempotent

Get a lead.

Requires scope leads:read.

Inputs: id (required).

get_meC
Read-onlyIdempotent

The team and API key making the request.

Inputs: no named parameters.

get_referral_statsB
Read-onlyIdempotent

Referral link and stats.

Requires scope referrals:read.

Inputs: no named parameters.

get_team_configB
Read-onlyIdempotent

Team settings and coaching context.

Requires scope team:read.

Inputs: no named parameters.

get_usageA
Read-onlyIdempotent

Token and seat usage for the current period.

Requires scope billing:read.

Inputs: no named parameters.

get_webhook_endpointB
Read-onlyIdempotent

Get a webhook endpoint.

Requires scope webhooks:read.

Inputs: id (required).

list_api_keysA
Read-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_callsA
Read-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_stylesB
Read-onlyIdempotent

Built-in and team coaching styles.

Requires scope coaching:read.

Inputs: no named parameters.

list_invitesA
Read-onlyIdempotent

List pending invites.

Requires scope team:read.

Inputs: no named parameters.

list_leadsA
Read-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_membersA
Read-onlyIdempotent

List team members.

Requires scope team:read.

Inputs: no named parameters.

list_member_usageB
Read-onlyIdempotent

Per-member usage for the current period.

Requires scope billing:read.

Inputs: no named parameters.

list_webhook_deliveriesA
Read-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_endpointsA
Read-onlyIdempotent

List webhook endpoints.

Paginated: pass cursor = next_cursor from the previous result to get more.

Requires scope webhooks:read.

Inputs: limit, cursor.

remove_memberA
DestructiveIdempotent

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_keyA
Destructive

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_keyA
Destructive

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_secretA
Destructive

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_styleB
Idempotent

Update a custom coaching style.

Requires scope coaching:write.

Inputs: id (required), name, description, objectionStyle, +3 more.

update_leadB
Idempotent

Update a lead (only provided fields change).

Requires scope leads:write.

Inputs: id (required), name, email, notes, +8 more.

update_team_configC
Idempotent

Update team settings.

Requires scope team:write.

Inputs: name, industry, setGoals, crmBaseUrl, +15 more.

update_webhook_endpointC
Idempotent

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

    B3.3/5.0

    Scored across 41 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count3/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Connects 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.
      56
      17 npm
      1
      MIT
    • F
      license
      C
      quality
      C
      maintenance
      Exposes 153 tools to connect AI assistants to the Ploomes CRM, enabling CRUD operations, funnel configuration, CPQ, automations, and webhooks.
      100
      1
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      Connects AI assistants to the Ploomes CRM, exposing 153 tools for CRUD operations on entities, pipeline and field configuration, CPQ proposal models, automations, and webhooks.
      -
    • A
      license
      C
      quality
      D
      maintenance
      Provides 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.
      55
      2
      MIT