Centrex MCP Server
Click 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., "@Centrex MCP Server list contacts with status 'active'"
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.
Centrex MCP Server
MCP (Model Context Protocol) server for the Centrex Software CRM & LOS API v1. Gives Claude direct access to contacts, advances, documents, alerts, users, teams, and lender submissions.
Quick Install
Option A — Terminal (Claude Code)
claude mcp add centrex \
--command node \
--args "/path/to/centrex-mcp-server/dist/index.js" \
-e CENTREX_ACCESS_TOKEN=your_token_hereOption B — Manual JSON config
Add to ~/.claude.json (global) or .claude.json in your project:
{
"mcpServers": {
"centrex": {
"command": "node",
"args": ["/path/to/centrex-mcp-server/dist/index.js"],
"env": {
"CENTREX_ACCESS_TOKEN": "your_access_token_here",
"CENTREX_ACCOUNT_ID": "optional_account_id",
"CENTREX_ALLOW_DESTRUCTIVE_OPERATIONS": "false"
}
}
}
}Option C — Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"centrex": {
"command": "node",
"args": ["C:/path/to/centrex-mcp-server/dist/index.js"],
"env": {
"CENTREX_ACCESS_TOKEN": "your_access_token_here"
}
}
}
}Related MCP server: GHL MCP Server
Installation & Build
git clone https://github.com/AllianceGS-Development/centrex-mcp-server.git
cd centrex-mcp-server
npm install
npm run build # compiles TypeScript → dist/Copy .env.example to .env and fill in your credentials, then point the config to dist/index.js.
Environment Variables
Variable | Required | Description |
| Yes | Bearer token from Centrex → Settings → API |
| No | Lock to a specific account/org ID |
| No | Set |
Get your API access token from your Centrex account under Settings → API or contact support@centrexsoftware.com.
Tools Reference
Contacts
centrex_list_contacts
Search and list contacts with optional filters.
Parameter | Type | Required | Description |
| string | No | Full-text search query |
| string | No | Filter by email |
| string | No | Filter by phone number |
| string | No | Filter by contact status |
| string | No | Results per page (default 25) |
| string | No | Pagination offset |
centrex_get_contact
Get a single contact by ID.
Parameter | Type | Required | Description |
| string | Yes | Contact ID |
centrex_create_contact
Create a new contact/lead.
Parameter | Type | Required | Description |
| string | Yes | First name |
| string | Yes | Last name |
| string | No | Email address |
| string | No | Phone number |
| string | No | Business/company name |
| string | No | Street address |
| string | No | City |
| string | No | State (2-letter) |
| string | No | ZIP code |
| string | No | Contact status |
| string | No | User to assign this contact to |
centrex_update_contact
Update an existing contact (partial update).
Parameter | Type | Required | Description |
| string | Yes | Contact ID to update |
| string | No | New first name |
| string | No | New last name |
| string | No | New email |
| string | No | New phone |
| string | No | New business name |
| string | No | New status |
| string | No | Reassign to user |
centrex_delete_contact
Delete a contact. Requires CENTREX_ALLOW_DESTRUCTIVE_OPERATIONS=true.
Parameter | Type | Required | Description |
| string | Yes | Contact ID to delete |
Contact Notes
centrex_get_contact_notes
Get all notes for a contact.
Parameter | Type | Required | Description |
| string | Yes | Contact ID |
centrex_create_contact_note
Add a note to a contact.
Parameter | Type | Required | Description |
| string | Yes | Contact ID |
| string | Yes | Note text |
| string | No | Note type/category |
Communication
centrex_send_communication
Send email or SMS to a contact.
Parameter | Type | Required | Description |
| string | Yes | Contact ID |
| string | Yes |
|
| string | Yes | Message body |
| string | Cond. | Required for email |
| string | No | Template ID to use |
Advances (Loans)
centrex_list_advances
List loan/advance records.
Parameter | Type | Required | Description |
| string | No | Filter by contact |
| string | No | Filter by status |
| string | No | Results per page |
| string | No | Pagination offset |
centrex_create_advance
Create a new loan/advance record.
Parameter | Type | Required | Description |
| string | Yes | Contact this advance belongs to |
| number | Yes | Advance amount |
| string | No | Status |
| string | No | Advance type |
| string | No | Notes |
Documents
centrex_list_documents
List documents.
Parameter | Type | Required | Description |
| string | No | Filter by contact |
| string | No | Results per page |
| string | No | Pagination offset |
centrex_get_document
Get document metadata and download URL.
Parameter | Type | Required | Description |
| string | Yes | Document ID |
Alerts
centrex_list_alerts
List alerts/reminders.
Parameter | Type | Required | Description |
| string | No | Filter by contact |
| string | No | Filter by status |
| string | No | Results per page |
| string | No | Pagination offset |
centrex_create_alert
Create an alert/reminder.
Parameter | Type | Required | Description |
| string | Yes | Contact ID |
| string | Yes | Alert message |
| string | No | ISO 8601 due date |
| string | No | User to assign to |
| string | No | Alert type |
Users & Teams
centrex_list_users
List users/agents.
Parameter | Type | Required | Description |
| string | No | Results per page |
| string | No | Pagination offset |
centrex_get_user
Get a user by ID.
Parameter | Type | Required | Description |
| string | Yes | User ID |
centrex_list_teams
List teams.
Parameter | Type | Required | Description |
| string | No | Results per page |
| string | No | Pagination offset |
Lender Submissions
centrex_list_submissions
List lender submission records.
Parameter | Type | Required | Description |
| string | No | Filter by contact |
| string | No | Filter by status |
| string | No | Results per page |
| string | No | Pagination offset |
centrex_get_submission
Get a specific submission.
Parameter | Type | Required | Description |
| string | Yes | Submission ID |
Generic Escape Hatch
centrex_request
Make a raw authenticated request to any Centrex API endpoint not covered by dedicated tools.
Parameter | Type | Required | Description |
| string | Yes |
|
| string | Yes | API path starting with |
| object | No | Query string parameters |
| object | No | Request body for POST/PUT/PATCH |
Centrex API Endpoint Reference
Resource | Method | Endpoint | Description |
Contacts | GET |
| List/search contacts |
Contacts | POST |
| Create contact |
Contacts | GET |
| Get contact |
Contacts | PUT |
| Update contact |
Contacts | DELETE |
| Delete contact |
Contact Notes | GET |
| Get notes |
Contact Notes | POST |
| Add note |
Communication | POST |
| Send email/SMS |
Forms | POST |
| Send external form |
Advances | GET |
| List advances |
Advances | POST |
| Create advance |
Advances | GET |
| Get advance |
Advances | PUT |
| Update advance |
Documents | GET |
| List documents |
Documents | POST |
| Upload document |
Documents | GET |
| Get document |
Alerts | GET |
| List alerts |
Alerts | POST |
| Create alert |
Alerts | PUT |
| Update alert |
Alerts | DELETE |
| Delete alert |
Users | GET |
| List users |
Users | POST |
| Create user |
Users | GET |
| Get user |
Users | PUT |
| Update user |
Users | DELETE |
| Delete user |
Users | GET |
| User preferences |
Teams | GET |
| List teams |
Teams | POST |
| Create team |
Teams | GET |
| Get team |
Teams | PUT |
| Update team |
Teams | DELETE |
| Delete team |
Submissions | GET |
| List submissions |
Submissions | GET |
| Get submission |
Submissions | GET |
| Submission status |
Credit Reports | GET |
| Credit report data |
Webhooks | POST |
| Configure webhooks |
Security
Bearer token is never logged or exposed in output
Sensitive fields are redacted from responses
SSRF protection: only
api.centrexsoftware.comis reachableDestructive operations (DELETE) require explicit opt-in via
CENTREX_ALLOW_DESTRUCTIVE_OPERATIONS=true
License
MIT — Alliance Global Solutions 2026
Available Tools
20 toolscentrex_create_advanceC
Create a new loan/advance record in Centrex.
Inputs: amount (required), contact_id (required), type, notes, +1 more.
centrex_create_alertB
Create a new alert/reminder in Centrex.
Inputs: message (required), contact_id (required), type, due_date, +1 more.
centrex_create_contactB
Create a new contact/lead in Centrex CRM.
Inputs: last_name (required), first_name (required), zip, city, +7 more.
centrex_create_contact_noteB
Add a note to a contact record.
Inputs: note (required), contact_id (required), type.
centrex_delete_contactA
Delete a contact from Centrex CRM. Requires CENTREX_ALLOW_DESTRUCTIVE_OPERATIONS=true.
Inputs: contact_id (required).
centrex_get_contactA
Get a single contact by ID including all CRM fields, notes, and metadata.
Inputs: contact_id (required).
centrex_get_contact_notesB
Get all notes for a contact.
Inputs: contact_id (required).
centrex_get_documentB
Get metadata and download URL for a specific document.
Inputs: document_id (required).
centrex_get_submissionB
Get details and status of a specific lender submission.
Inputs: submission_id (required).
centrex_get_userA
Get a specific user by ID.
Inputs: user_id (required).
centrex_list_advancesB
List all loan/advance records in Centrex.
Inputs: limit, offset, status, contact_id.
centrex_list_alertsC
List alerts/notifications in Centrex.
Inputs: limit, offset, status, contact_id.
centrex_list_contactsB
Search and list contacts in Centrex CRM. Supports filtering by name, email, phone, status, and more.
Inputs: email, limit, phone, offset, +2 more.
centrex_list_documentsC
List documents in Centrex, optionally filtered by contact.
Inputs: limit, offset, contact_id.
centrex_list_submissionsB
List lender submission records in Centrex.
Inputs: limit, offset, status, contact_id.
centrex_list_teamsB
List teams in the Centrex account.
Inputs: limit, offset.
centrex_list_usersB
List users/agents in the Centrex account.
Inputs: limit, offset.
centrex_requestA
Make a raw authenticated request to any Centrex API endpoint. Use this for endpoints not covered by dedicated tools. DELETE and destructive POST paths require CENTREX_ALLOW_DESTRUCTIVE_OPERATIONS=true.
Inputs: path (required), method (required), body, params.
centrex_send_communicationC
Send an email or SMS to a contact.
Inputs: type (required), message (required), contact_id (required), subject, +1 more.
centrex_update_contactC
Update an existing contact in Centrex CRM. Only provided fields are updated.
Inputs: contact_id (required), email, phone, status, +4 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 20 tools
Each tool targets a distinct resource and action (e.g., list_contacts, get_contact, create_contact), with no overlapping purposes. The raw request tool is a catch-all that does not conflict with dedicated tools.
All tools use the consistent 'centrex_' prefix and snake_case, with most following a verb_noun pattern (e.g., list_contacts, create_contact). The only minor inconsistency is 'centrex_request', which lacks a verb (compared to e.g., 'send_communication').
20 tools is slightly above the typical 3-15 range but still appropriate for a CRM covering multiple domains (contacts, users, teams, advances, documents, alerts, submissions). Each tool serves a clear purpose, and the raw request endpoint justifies a larger surface.
Contacts have full CRUD and notes, but other resources are incomplete: users only have list/get, advances only list/create, documents only list/get, alerts only list/create, submissions only list/get. Missing update/delete for these resources are notable gaps that may require the raw request tool.
Maintenance
Related MCP Connectors
Create contacts, move deals, send proposals and invoices, read your inbox, from Claude or ChatGPT.
Every Canopy public API operation as a tool, run as you after a browser sign-in or on an API key.
Real estate CRM for Claude and ChatGPT: find leads and listings, report on pipeline, log follow-ups.
Operate the Plixana CRM from any AI: contacts, deals, quotes, WhatsApp and metrics.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides full CRUD access to Pipedrive CRM API, enabling Claude and other LLM applications to manage deals, persons, organizations, activities, notes, and leads with advanced filtering and fuzzy search capabilities.97 npm6MIT
- AlicenseNot gradedqualityDmaintenanceEnables Claude to manage GoHighLevel CRM contacts, pipelines, and workflows through natural language commands.91 npmMIT
- AlicenseNot gradedqualityDmaintenanceEnables Claude to interact with Follow Up Boss CRM, allowing lead management, task scheduling, and pipeline tracking through natural language.MIT
- FlicenseCqualityDmaintenanceEnables Claude to interact with GoHighLevel CRM for contact management, messaging, calendar, and sales opportunities via 14 tools.20-