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.
- Claude: Customize → Connectors → Add custom connector → paste the address.
- ChatGPT: chatgpt.com/plugins → + → Add custom MCP server → paste the address, authentication OAuth.
- 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 leadschats:read— Read lead chats and notescalls:read— Read calls, transcripts and recordingscatalog:read— Read technicians, the price list and dictionariesreports: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 leadstasks:write— Create tasks for the team
Prepare things for you to review
leads:create— Create leadsleads:write— Update lead fields (name, contact, address, tags, assigned dispatcher)status:write— Change a lead status (funnel stage), close a lead with a reasoncompanies:write— Create and update companies, link leads to themfiles:write— Attach files to leads (photos, documents)estimates:draft— Create draft estimates — a person reviews and sendsinvoices: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 startwebhooks: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.
| Tool | What it does | Right needed |
|---|---|---|
list_leads | List leads with rich filters | leads:read |
get_lead | Get a lead with its chat and notes | leads:read |
list_webhooks | List my webhook endpoints | webhooks:manage |
search | Search the CRM | leads:read |
fetch | Fetch a lead by id | leads:read |
list_technicians | List technicians | catalog:read |
get_price_list | Price list | catalog:read |
get_dictionaries | Dictionaries | catalog:read |
list_calls | Calls of a lead | calls:read |
list_neuro_sessions | Neuro Home conversations | calls:read |
get_neuro_session | Neuro Home conversation | calls:read |
get_call | Call details | calls:read |
get_reports_summary | Reports summary | reports:read |
get_audit_log | Who changed what | leads:read |
list_tasks | Open tasks | tasks:write |
list_estimates | Estimates of a lead | money:read |
list_invoices | Invoices of a lead | money:read |
get_estimate | Estimate details | money:read |
get_invoice | Invoice details | money:read |
list_campaigns | List campaigns | campaigns:write |
get_campaign | Campaign details | campaigns:write |
list_companies | Find companies | companies:read |
get_company | Company with its leads | companies:read |
get_thread | Conversation of a lead | leads:read |
get_payments | Payments of a lead | money:read |
find_estimates | Find estimates across all cards | money:read |
find_invoices | Find invoices across all cards | money:read |
find_payments | Recent payments across all cards | money:read |
get_schedule | Technician schedule | schedule:read |
get_changes | What changed since | leads:read |
get_waiting | Who is waiting | leads:read |
lookup | Find a person | leads:read |
list_files | Files of a lead | leads:read |
get_setup | Setup status — START HERE to configure a workspace | setup:write |
get_blocks | The workspace as blocks — what is on, what is not, who can switch it on | setup:write |
get_phone_setup | Twilio phone status, balance, and available numbers | setup:write |
get_crm_migration_playbooks | Get CRM migration guides (Housecall Pro, Jobber, Workiz, GoHighLevel, ServiceTitan) | setup:write |
get_team | The team | team:read |
get_team_locations | Where the technicians are | team:read |
get_timesheets | Timesheets | team:read |
get_payroll | Payroll totals | team:read |
list_my_feedback | What happened to the feedback sent from this workspace | |
Add records
Add something inside your workspace; nothing is overwritten and nobody outside is told.
| Tool | What it does | Right needed |
|---|---|---|
create_lead | Create a lead | leads:create |
add_note | Add an internal note | notes:write |
draft_estimate | Draft an estimate | estimates:draft |
draft_invoice | Draft an invoice | invoices:draft |
create_campaign | Draft an SMS campaign | campaigns:write |
create_company | Create a company | companies:write |
link_lead_company | Link a lead to a company | companies:write |
attach_estimate_photo | Put a picture on an estimate | estimates:draft |
export_conversation_pdf | Export a conversation as PDF | files:write |
attach_file | Attach a file to a lead | files:write |
add_technician | Add 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.
| Tool | What it does | Right needed |
|---|---|---|
create_task | Create a task for a person | tasks:write |
update_lead | Update lead fields | leads:write |
mark_invoice_paid | Record a payment | invoices:mark_paid |
void_invoice | Void an invoice | invoices:void |
void_estimate | Void an estimate | estimates:send |
save_business_rule | Save a business rule / playbook policy | setup:write |
add_price | Add a price-list item | prices:write |
update_price | Change a price-list item | prices:write |
update_company | Update a company | companies:write |
set_status | Change lead status | status:write |
block_number | Block the customer's number | leads:write |
unblock_number | Unblock the customer's number | leads:write |
close_lead | Close a lead with a reason | status:write |
update_task | Close, reassign or move a task | tasks:write |
update_estimate | Edit a draft estimate | estimates:draft |
update_invoice | Edit a draft invoice | invoices:draft |
update_profile | Save company profile settings | setup:write |
set_prices | Set the price list | setup:write |
set_schedule | Set working hours | setup:write |
add_staff | Add a dispatcher login | setup:write or team:write |
buy_phone_number | Buy a Twilio business phone number | setup:write |
import_crm_batch | Batch import records from another CRM (JSON or CSV converted) | setup:write |
complete_setup | Mark the workspace live | setup:write |
update_technician | Update a technician | team:write |
set_technician_areas | Set a technician's service areas | team:write |
update_staff | Update a staff login | team: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.
| Tool | What it does | Right needed |
|---|---|---|
send_message | Send a message to the customer | chat:write |
register_webhook | Register a webhook endpoint | webhooks:manage |
send_invoice | Send an invoice | invoices:send |
send_estimate | Send an estimate | estimates:send |
call_customer | Call the customer | calls:create |
start_campaign | Start a campaign | campaigns:write |
book_visit | Book a visit | visits:write |
parse_website | Read the company website into the profile | setup:write |
submit_a2p_registration | Submit A2P 10DLC texting registration | setup:write |
run_crm_api_extract | Extract data directly from old CRM via API | setup:write |
send_feedback | Tell the NeurLead team what to improve | |
Resources and ready-made commands
Resources
neurlead://company— Who the company is: brand, services, cities, hours, phone, AI persona, pricing model. Read once, keep in context.neurlead://price-list— Every active service with price and type (fixed / hourly / quote) and the hourly terms. Quote only from here.neurlead://dictionaries— Valid lead statuses, lead sources, service cities, dispatcher usernames, channels, temperatures.neurlead://team— Staff logins, technicians with areas and rates, service areas with ids.neurlead://setup— What is still missing in this workspace (todo), the owner-only clicks (human_steps), every profile key, and the playbook for setting the CRM up.neurlead://lead/{id}— One lead as text: details, request, notes, recent chat (same as the fetch tool).
Ready-made commands
morning— Morning brief: What needs a person first thing: customers waiting, today's visits, overdue tasks, unpaid invoices.waiting— Customers waiting for a reply: Every lead where the customer wrote last and nobody answered; a ready reply for each.photo_estimate— Estimate from photos: Draft an estimate for a lead from its photos and description, priced from the price list.after_call— After a call: Turn a call into the card: summary, next step, task.team_check— Technicians today: Who is late, which jobs are not closed, whose hours are missing.dunning— Follow up on money: Estimates without an answer, unpaid invoices, bookings without a deposit — with a short nudge for each.evening— Evening summary: What was closed, sold, moved and left for tomorrow.setup_crm— Set up this CRM (5-Minute Magic Onboarding): Complete automated workspace onboarding: crawl Google Maps & website, extract branding, hours, prices & reviews, then interview the owner for missing details.
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.