Max CRM MCP by usefulapi

Read leads, notes, appointments and activity; create and update leads and add notes in Max CRM.

Should I use this

Quality & Safety

A
Description quality
100%
Schema completeness
83%
Naming quality
100%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~2,323Tokens (tool definitions)
~1.9 KBTypical response size
Moderate attention impact (1.81% of 128k context)

This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

{
  "mcpServers": {
    "max-crm": {
      "url": "https://max-crm.usefulapi.io/mcp"
    }
  }
}

Remote endpoints

https://max-crm.usefulapi.io/mcpstreamable-http

What it can do

Tool inventory

Tools (10)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢maxcrm_get_account

Show the Max CRM account behind the key: token access (full or read only), today's usage, limits and lead routing. Max CRM API: GET /api/v1/me.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢maxcrm_get_reference

List the allowed lead statuses, lead types, origins, webhook events and limits. Use it before setting a status or lead type. Max CRM API: GET /api/v1/reference.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢maxcrm_list_leads(status, source, phone, updated_since, limit, ...)

List leads, newest first. Filter by status, source, phone or updated_since. Page with next_cursor. Max CRM API: GET /api/v1/leads.

Input Schema

{
  "type": "object",
  "properties": {
    "status": {
      "description": "Pipeline status, for example new_lead or appointment_scheduled. maxcrm_get_reference lists them all.",
      "type": "string",
      "maxLength": 60
    },
    "source": {
      "description": "Only this source, exact match.",
      "type": "string",
      "maxLength": 200
    },
    "phone": {
      "description": "Only this phone (any format; the last 10 digits are used).",
      "type": "string",
      "maxLength": 25
    },
    "updated_since": {
      "description": "Only leads changed at or after this time.",
      "type": "string",
      "maxLength": 40
    },
    "limit": {
      "description": "Page size, 1 to 100 (default 50).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "cursor": {
      "description": "next_cursor from the previous page.",
      "type": "string",
      "maxLength": 500
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢maxcrm_get_lead(id)

Show one lead by id, including monthly_premium, coverage_amount, policy_number and vendor when set. Max CRM API: GET /api/v1/leads/{id}.

Input Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Lead id."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢maxcrm_list_lead_notes(id)

List the notes on a lead's phone that this account wrote, newest first (up to 50). Max CRM API: GET /api/v1/leads/{id}/notes.

Input Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Lead id."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢maxcrm_list_appointments(from, to, lead_id, limit, cursor)

List appointments, newest first. Filter by first and last date (YYYY-MM-DD) or by lead. Page with next_cursor. Max CRM API: GET /api/v1/appointments.

Input Schema

{
  "type": "object",
  "properties": {
    "from": {
      "description": "First appointment date, YYYY-MM-DD.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "to": {
      "description": "Last appointment date, YYYY-MM-DD.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "lead_id": {
      "description": "Only this lead.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "limit": {
      "description": "Page size, 1 to 100 (default 50).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "cursor": {
      "description": "next_cursor from the previous page.",
      "type": "string",
      "maxLength": 500
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢maxcrm_list_activity(since, limit, cursor)

Read the newest-first feed of status changes, notes, calls and texts for this account's leads. Page with next_cursor. Max CRM API: GET /api/v1/activity.

Input Schema

{
  "type": "object",
  "properties": {
    "since": {
      "description": "Only events at or after this time.",
      "type": "string",
      "maxLength": 40
    },
    "limit": {
      "description": "Page size, 1 to 500 (default 100).",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    },
    "cursor": {
      "description": "next_cursor from the previous page.",
      "type": "string",
      "maxLength": 500
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴maxcrm_create_lead(first_name, last_name, phone, email, date_of_birth, ...)

Add one lead to the account. Give a phone and a first or last name. A phone already on file returns DUPLICATE_PHONE with the existing lead id. The account's own new-lead rules (drip, first messages, consent) apply. Max CRM API: POST /api/v1/leads.

Input Schema

{
  "type": "object",
  "properties": {
    "first_name": {
      "description": "First name.",
      "type": "string",
      "maxLength": 100
    },
    "last_name": {
      "description": "Last name.",
      "type": "string",
      "maxLength": 100
    },
    "phone": {
      "type": "string",
      "minLength": 7,
      "maxLength": 25,
      "description": "Phone number, 7 to 15 digits. Required."
    },
    "email": {
      "description": "Email address.",
      "type": "string",
      "maxLength": 254
    },
    "date_of_birth": {
      "description": "Date of birth, YYYY-MM-DD.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "address": {
      "description": "Street address.",
      "type": "string",
      "maxLength": 200
    },
    "city": {
      "description": "City.",
      "type": "string",
      "maxLength": 100
    },
    "state": {
      "description": "State, usually two letters.",
      "type": "string",
      "maxLength": 50
    },
    "zip_code": {
      "description": "ZIP code.",
      "type": "string",
      "maxLength": 20
    },
    "age": {
      "description": "Age in years.",
      "type": "integer",
      "minimum": 0,
      "maximum": 120
    },
    "status": {
      "description": "Pipeline status, for example new_lead or appointment_scheduled. maxcrm_get_reference lists them all.",
      "type": "string",
      "maxLength": 60
    },
    "source": {
      "description": "Where the lead came from, free text, for example \"Facebook Ad\".",
      "type": "string",
      "maxLength": 200
    },
    "lead_type": {
      "description": "final_expense, term, iul, annuities, general, retirement, real_estate, auto_insurance or custom.",
      "type": "string",
      "maxLength": 40
    },
    "coverage_amount": {
      "description": "Coverage amount, a number.",
      "type": "number",
      "minimum": 0
    },
    "monthly_premium": {
      "description": "Monthly premium, a number.",
      "type": "number",
      "minimum": 0
    },
    "tobacco_use": {
      "description": "Tobacco use, for example \"Yes\" or \"No\".",
      "type": "string",
      "maxLength": 50
    },
    "health_class": {
      "description": "Health class, free text.",
      "type": "string",
      "maxLength": 100
    },
    "do_not_call": {
      "description": "true stops calls and the drip.",
      "type": "boolean"
    },
    "notes": {
      "description": "The first note on the lead.",
      "type": "string",
      "maxLength": 5000
    }
  },
  "required": [
    "phone"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴maxcrm_update_lead(id, first_name, last_name, phone, email, ...)

Change some fields of one lead. Changing status goes through the same rules as the CRM and can start its automations. Fields not given stay as they are. Max CRM API: PATCH /api/v1/leads/{id}.

Input Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Lead id."
    },
    "first_name": {
      "description": "First name.",
      "type": "string",
      "maxLength": 100
    },
    "last_name": {
      "description": "Last name.",
      "type": "string",
      "maxLength": 100
    },
    "phone": {
      "description": "Phone number, 7 to 15 digits. Unique within the account.",
      "type": "string",
      "minLength": 7,
      "maxLength": 25
    },
    "email": {
      "description": "Email address.",
      "type": "string",
      "maxLength": 254
    },
    "date_of_birth": {
      "description": "Date of birth, YYYY-MM-DD.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "address": {
      "description": "Street address.",
      "type": "string",
      "maxLength": 200
    },
    "city": {
      "description": "City.",
      "type": "string",
      "maxLength": 100
    },
    "state": {
      "description": "State, usually two letters.",
      "type": "string",
      "maxLength": 50
    },
    "zip_code": {
      "description": "ZIP code.",
      "type": "string",
      "maxLength": 20
    },
    "age": {
      "description": "Age in years.",
      "type": "integer",
      "minimum": 0,
      "maximum": 120
    },
    "status": {
      "description": "Pipeline status, for example new_lead or appointment_scheduled. maxcrm_get_reference lists them all.",
      "type": "string",
      "maxLength": 60
    },
    "source": {
      "description": "Where the lead came from, free text, for example \"Facebook Ad\".",
      "type": "string",
      "maxLength": 200
    },
    "lead_type": {
      "description": "final_expense, term, iul, annuities, general, retirement, real_estate, auto_insurance or custom.",
      "type": "string",
      "maxLength": 40
    },
    "coverage_amount": {
      "description": "Coverage amount, a number.",
      "type": "number",
      "minimum": 0
    },
    "monthly_premium": {
      "description": "Monthly premium, a number.",
      "type": "number",
      "minimum": 0
    },
    "tobacco_use": {
      "description": "Tobacco use, for example \"Yes\" or \"No\".",
      "type": "string",
      "maxLength": 50
    },
    "health_class": {
      "description": "Health class, free text.",
      "type": "string",
      "maxLength": 100
    },
    "do_not_call": {
      "description": "true stops calls and the drip.",
      "type": "boolean"
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴maxcrm_add_lead_note(id, note)

Add one activity note to a lead's phone. The CRM keeps 25 notes per phone (NOTE_LIMIT_REACHED after that). Max CRM API: POST /api/v1/leads/{id}/notes.

Input Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Lead id."
    },
    "note": {
      "type": "string",
      "minLength": 1,
      "maxLength": 5000,
      "description": "Note text, up to 5000 characters."
    }
  },
  "required": [
    "id",
    "note"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded10 tools