NeurLead NeurLead

Documentation

NeurLead connector reference

What the connector does, what you give it, and every tool it offers. The tool table below is generated from the running server, so it is always current.

What it is

NeurLead is a CRM and AI dispatcher for home-service companies. The connector is a remote MCP server (Streamable HTTP) at https://aidispatch.us/connect/mcp. Your AI assistant (Claude, ChatGPT or any MCP client) uses it to work with one NeurLead workspace: yours.

Connect

Your AI plan

Your AI app must allow a custom connector. ChatGPT needs a paid plan: the free plan has no connector option, so it cannot connect. For Claude, Muse and other apps it depends on your plan and country, so look for a custom connector (MCP) option in yours. The limit is in the AI app, not in NeurLead.

  1. Claude: Customize → Connectors → Add custom connector → paste the address.
  2. ChatGPT: chatgpt.com/plugins → + → Add custom MCP server → paste the address, authentication OAuth.
  3. In the window that opens, type your workspace name (the part of your CRM address after /t/), sign in as its owner, tick the rights and press Allow selected.

Sign-in is OAuth 2.0 with PKCE and dynamic client registration; your password never goes to the AI. Access tokens last one hour, refresh tokens thirty days. No workspace yet? Create one.

Rights you give

You tick them on the consent screen. Through this address only “look” and “notes and tasks” are ticked at the start. To add rights later, disconnect and connect again.

Look at your data (ticked at the start)

  • leads:read — Read leads
  • chats:read — Read lead chats and notes
  • calls:read — Read calls, transcripts and recordings
  • catalog:read — Read technicians, the price list and dictionaries
  • reports:read — Read reports (revenue, unpaid invoices, funnel, schedule)
  • schedule:read — Read technician schedules (booked visits, free time)
  • companies:read — Read companies and their leads

Keep notes and tasks for your team (ticked at the start)

  • notes:write — Add internal notes to leads
  • tasks:write — Create tasks for the team

Prepare things for you to review

  • leads:create — Create leads
  • leads:write — Update lead fields (name, contact, address, tags, assigned dispatcher)
  • status:write — Change a lead status (funnel stage), close a lead with a reason
  • companies:write — Create and update companies, link leads to them
  • files:write — Attach files to leads (photos, documents)
  • estimates:draft — Create draft estimates — a person reviews and sends
  • invoices:draft — Create draft invoices — a person reviews and sends

Reach customers or touch money (a person approves each one)

  • chat:write — Reply to customers in a lead chat (sent only after the dispatcher approves, unless the owner sets the app to autonomous)
  • chats:write — Send messages to customers in lead chats (dispatcher approval required)
  • estimates:send — Send estimates to customers (under the app's mode) or void them (always approved by the owner)
  • invoices:send — Send invoices to customers (under the app's mode: approval by default)
  • invoices:mark_paid — Record payments on invoices (under the app's mode)
  • invoices:void — Void invoices (always approved by the owner)
  • calls:create — Place calls to customers through the dispatcher's phone (under the app's mode)
  • visits:write — Book visits — a person confirms, then the customer gets the booking text

See money details and team pay

  • money:read — Read estimates and invoices (amounts, status, items)
  • team:read — Read the team: staff, technicians with areas and rates, timesheets, payroll totals

Change settings, prices and the team

  • prices:write — Change the price list (always approved by the owner)
  • setup:write — Set the workspace up: company profile, price list, work hours, team, AI persona (before go-live at once; after go-live the owner approves each change)
  • team:write — Change the team: technicians, their areas, staff logins and toggles (no payroll marks, no passwords)
  • campaigns:write — Draft SMS campaigns with audience preview; the owner approves every start
  • webhooks:manage — Register its own webhook endpoints so the CRM can call it on new leads and replies

Safety

Your workspace only

The token names your workspace and is looked up only in its database. Nobody else’s AI can reach yours.

A person approves the risky parts

Sending invoices and estimates, recording payments, voiding invoices and booking visits always wait for a person, in every mode. Messages on sensitive topics (refunds, cancellations, complaints, damage, contracts, card numbers) always go to a person.

Modes

Per connected app: suggest only (default: the AI writes a draft), ask first (a person confirms in the CRM) or act itself (owner’s explicit choice).

Limits

120 requests a minute per token; at most 3 AI messages per lead per day, one without a customer reply in between, 200 per company per day.

Audit and revoke

Every call is logged in your workspace with the AI’s name. Revoke any time: CRM → Integrations → AI agents → Connected apps → Revoke. It takes effect at once.

No money movement

There is no charge, refund or payout tool. “Record a payment” only notes a payment the customer made outside the CRM, and waits for approval.

Tools

Each tool declares whether it only reads, adds, changes records, or reaches a customer or an outside party. Your AI sees only the tools your ticked rights allow.

Read only

Look at your workspace; change nothing.

ToolWhat it doesRight needed
list_leadsList leads with rich filtersleads:read
get_leadGet a lead with its chat and notesleads:read
list_webhooksList my webhook endpointswebhooks:manage
searchSearch the CRMleads:read
fetchFetch a lead by idleads:read
list_techniciansList technicianscatalog:read
get_price_listPrice listcatalog:read
get_dictionariesDictionariescatalog:read
list_callsCalls of a leadcalls:read
list_neuro_sessionsNeuro Home conversationscalls:read
get_neuro_sessionNeuro Home conversationcalls:read
get_callCall detailscalls:read
get_reports_summaryReports summaryreports:read
get_audit_logWho changed whatleads:read
list_tasksOpen taskstasks:write
list_estimatesEstimates of a leadmoney:read
list_invoicesInvoices of a leadmoney:read
get_estimateEstimate detailsmoney:read
get_invoiceInvoice detailsmoney:read
list_campaignsList campaignscampaigns:write
get_campaignCampaign detailscampaigns:write
list_companiesFind companiescompanies:read
get_companyCompany with its leadscompanies:read
get_threadConversation of a leadleads:read
get_paymentsPayments of a leadmoney:read
find_estimatesFind estimates across all cardsmoney:read
find_invoicesFind invoices across all cardsmoney:read
find_paymentsRecent payments across all cardsmoney:read
get_scheduleTechnician scheduleschedule:read
get_changesWhat changed sinceleads:read
get_waitingWho is waitingleads:read
lookupFind a personleads:read
list_filesFiles of a leadleads:read
get_setupSetup status — START HERE to configure a workspacesetup:write
get_blocksThe workspace as blocks — what is on, what is not, who can switch it onsetup:write
get_phone_setupTwilio phone status, balance, and available numberssetup:write
get_crm_migration_playbooksGet CRM migration guides (Housecall Pro, Jobber, Workiz, GoHighLevel, ServiceTitan)setup:write
get_teamThe teamteam:read
get_team_locationsWhere the technicians areteam:read
get_timesheetsTimesheetsteam:read
get_payrollPayroll totalsteam:read
list_my_feedbackWhat happened to the feedback sent from this workspace

Add records

Add something inside your workspace; nothing is overwritten and nobody outside is told.

ToolWhat it doesRight needed
create_leadCreate a leadleads:create
add_noteAdd an internal notenotes:write
draft_estimateDraft an estimateestimates:draft
draft_invoiceDraft an invoiceinvoices:draft
create_campaignDraft an SMS campaigncampaigns:write
create_companyCreate a companycompanies:write
link_lead_companyLink a lead to a companycompanies:write
attach_estimate_photoPut a picture on an estimateestimates:draft
export_conversation_pdfExport a conversation as PDFfiles:write
attach_fileAttach a file to a leadfiles:write
add_technicianAdd a technician (installer, crew, field worker)setup:write or team:write

Change records

Overwrite, close, book or record something inside your workspace. Money and visits wait for a person.

ToolWhat it doesRight needed
create_taskCreate a task for a persontasks:write
update_leadUpdate lead fieldsleads:write
mark_invoice_paidRecord a paymentinvoices:mark_paid
void_invoiceVoid an invoiceinvoices:void
void_estimateVoid an estimateestimates:send
save_business_ruleSave a business rule / playbook policysetup:write
add_priceAdd a price-list itemprices:write
update_priceChange a price-list itemprices:write
update_companyUpdate a companycompanies:write
set_statusChange lead statusstatus:write
block_numberBlock the customer's numberleads:write
unblock_numberUnblock the customer's numberleads:write
close_leadClose a lead with a reasonstatus:write
update_taskClose, reassign or move a tasktasks:write
update_estimateEdit a draft estimateestimates:draft
update_invoiceEdit a draft invoiceinvoices:draft
update_profileSave company profile settingssetup:write
set_pricesSet the price listsetup:write
set_scheduleSet working hourssetup:write
add_staffAdd a dispatcher loginsetup:write or team:write
buy_phone_numberBuy a Twilio business phone numbersetup:write
import_crm_batchBatch import records from another CRM (JSON or CSV converted)setup:write
complete_setupMark the workspace livesetup:write
update_technicianUpdate a technicianteam:write
set_technician_areasSet a technician's service areasteam:write
update_staffUpdate a staff loginteam:write

Reach a customer or an outside party

Send a message, invoice, estimate or campaign, place a call, or tell an outside endpoint. Cannot be recalled; held for a person unless you chose otherwise.

ToolWhat it doesRight needed
send_messageSend a message to the customerchat:write
register_webhookRegister a webhook endpointwebhooks:manage
send_invoiceSend an invoiceinvoices:send
send_estimateSend an estimateestimates:send
call_customerCall the customercalls:create
start_campaignStart a campaigncampaigns:write
book_visitBook a visitvisits:write
parse_websiteRead the company website into the profilesetup:write
submit_a2p_registrationSubmit A2P 10DLC texting registrationsetup:write
run_crm_api_extractExtract data directly from old CRM via APIsetup:write
send_feedbackTell the NeurLead team what to improve

Resources and ready-made commands

Resources

Ready-made commands

Troubleshooting

“Workspace not found”

Use the name from your CRM address: …/t/your-company/. Lowercase letters, digits and hyphens. A closed or suspended workspace answers the same way.

Sign-in loops

Sign in to your CRM in the same browser first, then retry. Clear cookies for aidispatch.us if it keeps looping.

A tool is missing

Tools follow the rights you ticked. Disconnect, connect again and tick the area you need.

Nothing was sent to the customer

By default the AI only drafts. Open the lead in the CRM: the draft waits there with Approve, Edit and Reject.

Disconnected after a while

Access renews itself. If you revoked the app or changed the owner’s access, connect again.

Still stuck

Write to support@neurlead.com.