Nexus MCP Server

Agent-native Ops OS for ecommerce and retail — CRM, orders, inventory, fulfillment, shipping, omnichannel messaging, social publishing, team chat, conversation intelligence, and more. All through a single MCP connection.

What is Nexus?

Nexus is a multi-tenant operations platform built for SMEs. It consolidates:

• CRM — contacts, companies, journey stages, customer-360 views
• Order Management — full lifecycle from pending → delivered
• Inventory & Warehousing — stock tracking, bins, cycle counts
• Fulfillment — pick, pack, ship workflows
• Shipping — AWB creation, courier integration (Bosta), tracking
• Omnichannel Messaging — WhatsApp, Facebook Messenger, Instagram DMs
• Social Publishing — Facebook & Instagram drafts, scheduling, analytics, content calendar
• Internal Team Chat — agent ↔ human DMs inside the org
• Organization Invites — invite, cancel, and resend member invitations via agent
• VoIP/PBX — click-to-call, CDR sync, extensions
• Conversation Intelligence — AI message annotations, CS analytics, tag definitions, org AI profiles
• Automation — event-driven workflows, abandoned cart recovery

For AI Agents

Nexus is designed for agent-first access. AI agents authenticate with an API key and get 40+ MCP tools covering all business operations.

Quick Start (for agents)

Step 1: A human admin creates an API key

curl -X POST "https://api.nexus.aiforstartups.io/functions/v1/agent-api-key-create"
-H "Authorization: Bearer "
-H "Content-Type: application/json"
-d '{ "name": "my-agent", "scopes": ["read", "write"], "expires_at": "2026-12-31T23:59:59Z" }'

Returns: api_key (save this — shown only once), organization_id

Step 2: Exchange API key for a short-lived JWT

curl -X POST "https://api.nexus.aiforstartups.io/functions/v1/agent-auth"
-H "Content-Type: application/json"
-d '{"api_key": "nxs_ak_..."}'

Returns: access_token (JWT, 1 hour), organization_id

Step 3: Use MCP

curl -X POST "https://api.nexus.aiforstartups.io/functions/v1/mcp-server"
-H "Authorization: Bearer "
-H "Content-Type: application/json"
-H "Accept: application/json, text/event-stream"
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

MCP Tools

CRM

Tool	Description
nexus_list_contacts	List/search contacts with filters
nexus_get_contact	Get full contact details
nexus_create_contact	Create a new contact
nexus_update_contact	Update contact fields

Orders

Tool	Description
nexus_list_orders	List orders with filters
nexus_get_order	Get order with line items
nexus_create_order	Create order with line items
nexus_update_order_status	Move order through lifecycle

Inventory

Tool	Description
nexus_list_inventory	List inventory items
nexus_check_stock	Check stock for item/SKU

Messaging

Tool	Description
nexus_list_conversations	List omnichannel conversations
nexus_send_message	Send via WhatsApp/FB/IG
nexus_search	Global search across all data

Social

Tool	Description
nexus_sync_social_posts	Sync posts from connected accounts
nexus_list_social_posts	List social posts
nexus_get_social_post	Get a single post
nexus_create_social_post	Create a draft post
nexus_update_social_post	Update a draft post
nexus_publish_social_post	Publish a post
nexus_delete_social_post	Delete a post
nexus_list_social_accounts	List connected social accounts
nexus_get_social_analytics	Get social analytics
nexus_get_content_calendar	Get scheduled content calendar

Organization

Tool	Description
nexus_list_organization_invites	List pending invites
nexus_invite_organization_member	Invite a new member
nexus_cancel_organization_invite	Cancel a pending invite
nexus_resend_organization_invite	Resend an invite email

Internal Team Chat

Tool	Description
nexus_list_internal_conversations	List agent's internal conversations
nexus_get_internal_messages	Get messages in a conversation
nexus_open_internal_dm	Open a DM with an org member
nexus_send_internal_message	Send an internal message

Conversation Intelligence (CS AI)

Tool	Description
nexus_list_ai_tag_definitions	List AI tag taxonomy
nexus_list_message_annotations	List message annotations
nexus_get_message_ai_annotation	Get annotation for a message
nexus_get_org_ai_annotation_settings	Get org AI settings
nexus_get_customer_conversation_intelligence	Get customer intelligence profile
nexus_get_conversation_intelligence_dashboard	Get CS analytics dashboard
nexus_update_message_annotation	Update a message annotation
nexus_update_ai_tag_definition	Update a tag definition
nexus_set_org_ai_annotation_prompt	Set org AI prompt
nexus_update_org_conversation_intelligence_context	Update org AI context

MCP Resources

Resource	Description
nexus://organization/info	Current org details
nexus://schema/contacts	Contact object schema
nexus://schema/orders	Order object schema
nexus://schema/inventory	Inventory object schema
nexus://schema/social	Social post schema
nexus://schema/conversation-intelligence	Conversation intelligence schema

Pricing

Tier	Price	Contacts	Orders	Messages	MCP Scopes
Free	$0	50	25	0	read
Starter	$99/mo	500	200/mo	1,000	read, write
Growth	$199/mo	5,000	unlimited	5,000	full
Scale	$599/mo	unlimited	unlimited	20,000	full + AI suite

Social tools require Starter plan or above. Conversation intelligence AI suite requires Scale.

OpenClaw Skill

Install the Nexus skill for OpenClaw agents:

npx clawhub@latest install nexus

Or install manually by copying SKILL.md into your OpenClaw workspace skills directory.

Documentation

• Agent Quickstart: nexus-docs.aiforstartups.io/api/ai-agents-mcp
• Full API Reference: api-reference.md
• Full Docs: nexus-docs.aiforstartups.io
• llms.txt: nexus-docs.aiforstartups.io/llms.txt
• OpenAPI Spec: nexus-docs.aiforstartups.io/openapi.yaml
• App: nexus.aiforstartups.io

Tech Stack

• Frontend: React 18 + TypeScript + Vite + Tailwind CSS + shadcn/ui
• Backend: Supabase (PostgreSQL + Edge Functions on Deno)
• Auth: Supabase Auth (JWT) with multi-tenant RLS
• MCP: Streamable HTTP transport

Built By

AiForStartups — Made in Cairo, Egypt 🇪🇬