Integration · MCP Server · Nexus

Nexus MCP Server: Connect Any AI Agent to Your Operations

Nexus ships a native MCP (Model Context Protocol) server. AI agents using Claude, Cursor, or any MCP-compatible platform can self-register, authenticate with an API key, and operate Nexus autonomously — reading orders, checking stock, sending messages, searching contacts, and updating statuses. No custom API integration required; the agent discovers available tools from the MCP manifest and starts working immediately.

What This Integration Does

The Model Context Protocol (MCP) is an open standard that lets AI agents discover and call tools exposed by external services. Rather than writing custom API integration code for every AI agent you want to use, you point the agent at the Nexus MCP manifest and it learns what Nexus can do by itself. The Nexus MCP server exposes the full operational surface of the platform as callable tools — meaning an AI agent can compose multi-step operations across orders, conversations, contacts, and inventory using natural language instructions. A Claude agent can check whether a flagged order is from a repeat customer, look up their conversation history, read the AI complaint signal, and send them a WhatsApp resolution message — all in a single autonomous run, without a human clicking through Nexus manually. The agent self-registers on first use and authenticates with a scoped JWT on every subsequent call.

Self-registering agent protocol

Agents discover the Nexus tool manifest at GET /.well-known/mcp.json, register themselves with POST /agent-register, and receive a scoped API key. On each session they exchange the key for a short-lived JWT via POST /agent-auth. All subsequent tool calls go to POST /mcp-server with the JWT in the Authorization header. No manual configuration in Nexus is needed beyond issuing the initial key.

Full operational tool coverage

The MCP tool set covers orders (read, search, status update), contacts (lookup, create, tag, update), conversations (read thread, post internal note), inventory (check stock, list low-stock items), messaging (send WhatsApp template or free-form message), and AI signals (read churn score, complaint flags, RFM segment). Agents on Scale plan get additional tools for analytics queries and bulk operations.

Plan-scoped permissions

Read-only MCP access is available on the Free tier so developers can explore the API surface and build agent prototypes at no cost. Write access — sending messages, updating statuses, modifying contacts — is unlocked on Growth and Scale plans. Each API key carries a permission scope, so you can issue a read-only key for a monitoring agent and a full-write key for an autonomous operations agent from the same Nexus account.

Setup & Requirements

Connecting an AI agent to the Nexus MCP server requires only an HTTP client and a Nexus account. The four-step protocol is standardized and works with any MCP-compatible agent framework without code changes on the Nexus side.

Frequently Asked Questions

What MCP tools are available in Nexus?
The Nexus MCP server exposes tools for: reading and searching orders by status, date range, courier, or customer; looking up, creating, and updating customer contacts; sending WhatsApp messages (both template and free-form); checking product stock levels; reading full conversation threads across channels; posting internal notes on conversations; updating order statuses; listing and assigning agents to tickets; and querying AI signal data including churn scores, complaint flags, sentiment, and RFM segments. The complete, versioned tool manifest is always available at /.well-known/mcp.json on your Nexus instance.
Can AI agents write to Nexus or only read?
Both, depending on your Nexus plan. Free tier MCP access is read-only — agents can query orders, contacts, conversations, and AI signal data but cannot make changes. Growth plan unlocks write access for messaging (sending WhatsApp messages) and note-posting on conversations. Scale plan enables full write access including order status updates, contact field mutations, tag management, and automation trigger calls. Write permissions are scoped per API key so you can issue a read-only key to a monitoring agent and a write key to an action-taking agent from the same account.
Which AI agents and platforms are compatible?
Any platform that implements the Model Context Protocol specification can connect to the Nexus MCP server. Tested and confirmed compatible: Claude via Anthropic's MCP client libraries, Cursor IDE (using the MCP server configuration), Continue.dev, and custom agents built with Python or Node.js MCP libraries. The protocol is an open standard — compatibility expands automatically as new MCP-compatible tools and platforms emerge. If your agent can make authenticated HTTP requests and parse a JSON tool manifest, it can use Nexus MCP.
Is MCP access included in my Nexus plan?
Yes, there is no separate MCP add-on. Read-only MCP access is included on the Free tier. Write access tiers are bundled with Growth and Scale plans respectively. API key management for MCP agents — issuing keys, setting scopes, revoking keys, viewing call logs — is all handled inside Nexus under Settings → API & Integrations → MCP Agents. You can have multiple agent keys active simultaneously.
How do I secure my MCP endpoint?
Security is layered. Each MCP agent authenticates with a unique scoped API key that you issue through Nexus settings — if a key is compromised, revoke it individually without affecting other agents. The API key is exchanged for a short-lived JWT before each session, so the long-lived key is never sent on tool calls. All MCP traffic is HTTPS-only with TLS 1.2 minimum. On Growth and Scale plans you can additionally set IP allowlists per API key in Nexus settings, restricting which hosts can use a given key — useful for production agents running on fixed infrastructure like cloud functions or dedicated servers.

Let your AI agents operate Nexus autonomously

Connect Claude, Cursor, or any MCP agent to your orders, conversations, and CRM — no custom integration code, no API wrapper, just the MCP manifest and a key.