MCP Server - Nexor

Nexor exposes the account-management capabilities in the catalog below as MCP (Model Context Protocol) tools, so an AI client — Claude, Cursor, or Codex — can operate them directly. MCP and REST share the same underlying resources, but their catalogs are not identical; use this page as the source of truth for available MCP tools.

Getting a key

MCP keys are separate from your REST X-API-Key (see Authentication) and carry their own scopes.

Open Integrations from your profile menu.
Go to MCP Server.
Create a key and pick the scopes it needs — least privilege by default. A read-only key can be handed to an agent you don’t fully trust yet.

Connecting a client

Server URL: https://mcp.getnexor.ai/mcp Claude Code

claude mcp add --transport http nexor https://mcp.getnexor.ai/mcp --header "X-API-Key: YOUR_MCP_KEY"

Cursor / Claude Desktop (~/.cursor/mcp.json or Claude’s connector settings)

{
  "mcpServers": {
    "nexor": {
      "url": "https://mcp.getnexor.ai/mcp",
      "headers": { "X-API-Key": "YOUR_MCP_KEY" }
    }
  }
}

Codex (~/.codex/config.toml)

[mcp_servers.nexor]
command = "npx"
args = ["-y", "mcp-remote", "https://mcp.getnexor.ai/mcp", "--header", "X-API-Key: YOUR_MCP_KEY"]

Scopes

A key can only call tools within its granted scopes.

Scope	Grants
`workflows:read`	View agents, their structure, custom tools, and background jobs
`workflows:write`	Create and edit agents, prompts, structure, custom tools, and background jobs
`leads:read`	View leads, history, and WhatsApp templates
`leads:write`	Create/update leads, tags, status, and automation state
`rules:read`	View reminder, recontact, and status-timeout rules
`rules:write`	Create/update those rules
`people:read`	View team members and pending invitations
`invites:write`	Invite or revoke people
`messages:send`	Send a WhatsApp/email/SMS message or trigger a call
`meetings:write`	Log meetings and meeting notes
`reports:read`	View funnel, field-distribution, call-stats, and per-lead reports
`numbers:read`	View the client’s phone numbers
`numbers:write`	Provision, assign, and manage phone numbers
`whatsapp:read`	View the client’s WhatsApp numbers
`whatsapp:write`	Connect, assign, and manage WhatsApp numbers

Tool catalog

Workflows (agents)

This is the full “create an agent that does A, then B, then C” toolset — it maps directly to the Workflows and Workflow Tools REST endpoints.

Tool	Scope	Description
`list_workflows`	`workflows:read`	List the client’s agents
`get_workflow`	`workflows:read`	Fetch one agent with statuses/fields/tools
`create_workflow`	`workflows:write`	Create an agent (funnel) with statuses
`set_workflow_prompt`	`workflows:write`	Replace an agent’s base (global) prompt
`set_workflow_active`	`workflows:write`	Activate (unpause) or pause an agent
`update_workflow`	`workflows:write`	Rename an agent or change its description
`set_channel_prompt`	`workflows:write`	Set a per-channel prompt override (merged)
`get_workflow_prompt_history`	`workflows:read`	Read an agent’s prompt version history
`update_workflow_structure`	`workflows:write`	Add/edit funnel statuses + fields (upsert, no delete)

Custom tools

Tools scoped to a single agent, with no catalog inheritance. Prefer the client tools catalog below when a tool should be reusable across agents.

Tool	Scope	Description
`list_workflow_tools`	`workflows:read`	List an agent’s custom HTTP tools
`create_workflow_tool`	`workflows:write`	Create a custom tool that lives only in this agent (no catalog inheritance); prefer `create_client_tool` + `assign_tool_to_workflow` for a reusable tool
`update_workflow_tool`	`workflows:write`	Edit a custom tool’s config
`delete_workflow_tool`	`workflows:write`	Remove a custom tool (soft/hard)
`set_tool_stage_gate`	`workflows:write`	Gate a custom tool to funnel stages

Client tools catalog

A two-level model: a client tool is a reusable definition in the client’s catalog; assigning it to an agent creates an inherited copy that stays in sync with the catalog tool on future edits. It maps to the Client Tools REST endpoints.

Tool	Scope	Description
`list_client_tools`	`workflows:read`	List the client’s reusable tool catalog
`create_client_tool`	`workflows:write`	Create a reusable tool in the catalog — the recommended way to add a tool usable across agents
`update_client_tool`	`workflows:write`	Edit a catalog tool; propagates to every agent that has assigned (inherited) it
`delete_client_tool`	`workflows:write`	Remove a tool from the catalog (cascades to inherited assignments)
`assign_tool_to_workflow`	`workflows:write`	Assign a catalog tool to an agent; it inherits and stays in sync with the catalog tool

Background jobs

Tool	Scope	Description
`list_background_jobs`	`workflows:read`	List background jobs
`get_background_job`	`workflows:read`	Get a background job + recent executions
`create_background_job`	`workflows:write`	Create a scheduled/forced lead automation
`update_background_job`	`workflows:write`	Update a background job config
`delete_background_job`	`workflows:write`	Delete a background job
`run_background_job`	`workflows:write`	Force-run a background job now
`list_background_job_executions`	`workflows:read`	A job’s execution history

Leads

Tool	Scope	Description
`list_leads`	`leads:read`	Page through leads with search/filter
`get_lead`	`leads:read`	One lead with fields + engagement
`get_lead_history`	`leads:read`	Unified lead timeline
`upsert_leads`	`leads:write`	Create/update leads (idempotent), optional enroll
`update_lead`	`leads:write`	Update lead fields/metadata
`sync_lead_tags`	`leads:write`	Set the exact tag set for a lead
`assign_lead_to_workflow`	`leads:write`	Move a lead into an agent, start cadence
`set_lead_status`	`leads:write`	Force a lead’s funnel status (forward/back)
`stop_automation`	`leads:write`	Human takeover on: pause cadence
`resume_automation`	`leads:write`	Human takeover off; optionally resume cadence
`delete_lead`	`leads:write`	Soft-delete (archive) a lead

Rules

Tool	Scope	Description
`list_reminder_rules`	`rules:read`	List lead reminder rules
`set_reminder_rule`	`rules:write`	Create/update a lead reminder rule
`list_host_reminder_rules`	`rules:read`	List host notification rules
`set_host_reminder_rule`	`rules:write`	Create/update a host rule (email only)
`list_recontact_rules`	`rules:read`	List re-engage rules
`set_recontact_rule`	`rules:write`	Create/update a re-engage rule
`list_status_timeout_rules`	`rules:read`	List status auto-timeout configs
`set_status_timeout_rule`	`rules:write`	Set/clear a status auto-timeout

People

Tool	Scope	Description
`list_team`	`people:read`	List active team members
`list_pending_invitations`	`people:read`	List outstanding invitations
`invite_user`	`invites:write`	Invite a person (admin or human agent), idempotent
`revoke_invitation`	`invites:write`	Cancel a pending invitation

Messaging

Tool	Scope	Description
`list_whatsapp_templates`	`leads:read`	List approved WhatsApp templates
`send_message`	`messages:send`	Send WhatsApp/email/SMS or trigger a call (SMS uses the workflow’s SMS-enabled number; `workflow_id` is optional — resolved from the lead’s active run)

Account

Tool	Scope	Description
`list_lead_meetings`	`leads:read`	List a lead’s calendar events
`create_meeting`	`meetings:write`	Log a booked meeting (idempotent)
`ingest_meeting_notes`	`meetings:write`	Attach transcript/summary to a meeting
`list_conversion_types`	`leads:read`	List active conversion types
`set_conversion_type`	`leads:write`	Create or update a conversion type by name
`create_conversion`	`leads:write`	Record a conversion event
`list_conversions`	`leads:read`	List conversion events
`list_campaigns`	`leads:read`	List campaigns

Reports

Tool	Scope	Description
`get_funnel_report`	`reports:read`	Aggregate funnel report: leads per status, contacted/connected/discovery totals, per agent
`get_field_distribution`	`reports:read`	Distribution of a captured lead field’s values, with counts and an example evidence quote
`get_call_stats`	`reports:read`	Call volume/outcome stats for a date range, totaled or broken down by day
`get_lead_report`	`reports:read`	Full report bundle for one lead: profile, status, fields, insights, calls, scheduled tasks

Phone numbers

Tool	Scope	Description
`search_available_numbers`	`numbers:read`	List numbers available to buy in a country
`list_phone_numbers`	`numbers:read`	List the client’s numbers and their workflow binding
`provision_phone_number`	`numbers:write`	Buy + provision a number (capped per client, default 3)
`assign_number_to_workflow`	`numbers:write`	(Re)assign a number to one of the client’s workflows
`set_number_sms`	`numbers:write`	Enable/disable inbound SMS on a number
`deactivate_number`	`numbers:write`	Soft-deactivate a number

Internal-admin keys additionally have release_phone_number, transfer_number, and dialing-permission tools.

WhatsApp numbers

Connecting returns a Kapso hosted setup link the client opens to finish onboarding; the number is then recorded automatically and its inbound webhook + events are registered — the same as any onboarded number. Binding a number to a workflow is what makes inbound messages reach that agent.

Tool	Scope	Description
`list_whatsapp_numbers`	`whatsapp:read`	List the client’s WhatsApp numbers and their workflow binding
`connect_whatsapp_number`	`whatsapp:write`	Start onboarding; returns a Kapso setup link (capped per client, default 10)
`assign_whatsapp_to_workflow`	`whatsapp:write`	Bind a WhatsApp number to a workflow so inbound reaches the agent
`deactivate_whatsapp_number`	`whatsapp:write`	Soft-deactivate a WhatsApp number

Internal-admin keys additionally have disconnect_whatsapp_number.

Tool	Scope	Description
`whoami`	—	Authenticated client identity + granted scopes

Errors

Every tool error follows the same shape: { "error": { "code": "...", "message": "..." } }.

Code	Meaning
`UNAUTHORIZED`	Missing or invalid MCP key
`FORBIDDEN`	The key is authenticated but lacks the scope this tool requires
`NOT_FOUND`	The requested resource doesn’t exist or isn’t yours
`INVALID_INPUT`	Missing or malformed arguments
`CONFLICT`	The request conflicts with the resource’s current state
`RATE_LIMITED`	Too many requests — back off and retry
`UPSTREAM_ERROR`	A transient Nexor-side issue or network failure; always the same fixed generic message, never the raw upstream body
`INTERNAL_ERROR`	Unexpected server error

Usage

Tool calls and error rates for the last 30 days are visible in the same Integrations → MCP Server page, per key.

​Getting a key

​Connecting a client

​Scopes

​Tool catalog

​Workflows (agents)

​Custom tools

​Client tools catalog

​Background jobs

​Leads

​Rules

​People

​Messaging

​Account

​Reports

​Phone numbers

​WhatsApp numbers

​Meta

​Errors

​Usage