# AiForStartups — Full LLM Context

> Complete context for AI models about AiForStartups and Nexus. For a quick overview see /llms.txt.

## About AiForStartups

AiForStartups is an AI automation and SaaS company founded in Cairo, Egypt in 2025. We build automation workflows and AI integrations for businesses. Our main product is Nexus, an agent-native operations platform for ecommerce and retail businesses.

**Website:** https://aiforstartups.io
**App:** https://nexus.aiforstartups.io
**Docs:** https://nexus-docs.aiforstartups.io
**Blog:** https://aiforstartups.io/blog
**GitHub:** https://github.com/karimsherifyehia/nexus-mcp-server
**Twitter:** @aiforstartups
**Email:** info@aiforstartups.io
**WhatsApp:** https://wa.me/20104000090

## Nexus — Product Overview

Nexus is a multi-tenant Ops OS (Operations Operating System) that replaces 5–7 separate business tools with one unified platform. It is built for ecommerce SMEs and retail businesses globally, with a strong focus on communication-heavy teams.

### Core Modules

1. **CRM** — Contact management, company records, customer journey stages (lead/prospect/customer/vip/churned), interaction history, RFM scoring, customer 360 view
2. **Order Management** — Full lifecycle: pending → confirmed → fulfilling → shipped → delivered → returned. Supports COD, prepaid, partial payment.
3. **Inventory & Warehousing** — Multi-warehouse support, bin locations, stock tracking, cycle counts, low-stock alerts, inventory valuation
4. **Fulfillment** — Pick list generation, packing slips, batch picking, warehouse workflows
5. **Shipping** — AWB creation, carrier integrations (Bosta courier), tracking, return management
6. **Omnichannel Messaging** — Unified inbox: WhatsApp Business API, Facebook Messenger, Instagram DMs, Email. Full conversation history linked to contacts.
7. **VoIP / PBX** — Issabel PBX integration, click-to-call, CDR sync, call recording, extension management
8. **AI Analytics** — Sentiment analysis, conversation transcription, embeddings, customer service dashboards (Scale tier only)
9. **Automation** — Event-driven workflows, abandoned cart recovery, n8n integration
10. **Competition Intelligence** — Market monitoring, competitor tracking

### Technical Architecture

- **Frontend:** React 18 + TypeScript + Vite + Tailwind CSS + shadcn/ui
- **Backend:** Supabase (PostgreSQL) with 143 database tables
- **Edge Functions:** 117+ Supabase Edge Functions running on Deno
- **Auth:** Supabase Auth (JWT) with multi-tenant Row Level Security (RLS)
- **MCP Transport:** Streamable HTTP (MCP protocol version 2025-03-26)
- **Integrations:** WhatsApp Business API, Meta (Facebook/Instagram), Shopify, Bosta, Issabel PBX, n8n

### Database Scale

143 tables organized into 16 functional groups:
contacts, orders, inventory, warehousing, fulfillment, shipping, conversations, messages, channels, calling, ai_processing, automation, analytics, competition, organizations, agents

## For AI Agents — Full Integration Guide

Nexus is built agent-native. AI agents can self-register, authenticate, and operate Nexus autonomously without any human involvement. The Free tier is designed to let agents explore the platform at zero cost.

### Endpoints

| Purpose | Method | URL |
|---|---|---|
| Agent self-registration | POST | https://lgwvoomgrwpsgpxwyaec.supabase.co/functions/v1/agent-register |
| API key → JWT auth | POST | https://lgwvoomgrwpsgpxwyaec.supabase.co/functions/v1/agent-auth |
| MCP server | POST | https://lgwvoomgrwpsgpxwyaec.supabase.co/functions/v1/mcp-server |
| MCP discovery | GET | https://nexus.aiforstartups.io/.well-known/mcp.json |
| Agent docs | GET | https://nexus-docs.aiforstartups.io/api/ai-agents-mcp |
| OpenAPI spec | GET | https://nexus-docs.aiforstartups.io/openapi.yaml |

### Self-Registration Flow (Step-by-Step)

**Step 1 — Register** (no auth required, no credit card):

```
POST https://lgwvoomgrwpsgpxwyaec.supabase.co/functions/v1/agent-register
Content-Type: application/json

{
  "agent_name": "your-agent-name",
  "agent_platform": "claude|cursor|openai|custom",
  "owner_email": "your@email.com",
  "organization_name": "Your Business Name",
  "plan": "free"
}
```

Response: `{ "api_key": "nxs_...", "organization_id": "uuid", "message": "Agent registered" }`

**Step 2 — Authenticate** (exchange API key for JWT):

```
POST https://lgwvoomgrwpsgpxwyaec.supabase.co/functions/v1/agent-auth
Content-Type: application/json

{
  "api_key": "nxs_..."
}
```

Response: `{ "access_token": "eyJ...", "expires_in": 3600 }`

**Step 3 — Initialize MCP session**:

```
POST https://lgwvoomgrwpsgpxwyaec.supabase.co/functions/v1/mcp-server
Authorization: Bearer {access_token}
Content-Type: application/json
Accept: application/json, text/event-stream

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-03-26",
    "capabilities": {},
    "clientInfo": { "name": "your-agent", "version": "1.0" }
  }
}
```

**Step 4 — Call MCP tools**:

```
POST https://lgwvoomgrwpsgpxwyaec.supabase.co/functions/v1/mcp-server
Authorization: Bearer {access_token}
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "nexus_list_contacts",
    "arguments": { "limit": 10 }
  }
}
```

### MCP Tools Reference (13 tools)

| Tool | Description |
|---|---|
| nexus_list_contacts | List contacts with optional filters (status, search, limit, offset) |
| nexus_get_contact | Get full contact details by ID |
| nexus_create_contact | Create a new contact (write tier required) |
| nexus_update_contact | Update contact fields (write tier required) |
| nexus_list_orders | List orders with filters (status, date range, limit) |
| nexus_get_order | Get full order details including line items |
| nexus_create_order | Create a new order (write tier required) |
| nexus_update_order_status | Update order status in lifecycle |
| nexus_list_inventory | List inventory items with stock levels |
| nexus_check_stock | Check stock availability for a specific SKU/product |
| nexus_list_conversations | List conversations from all channels |
| nexus_send_message | Send a message via connected channel (write tier required) |
| nexus_search | Cross-entity search across contacts, orders, conversations |

### Pricing Tiers

| Plan | Price | MCP Access | Contacts | Orders/mo | Messages/mo | API calls/day |
|---|---|---|---|---|---|---|
| Free | $0 | read-only | 50 | 25 | — | 500 |
| Starter | $99 | read+write | 500 | 200 | 1,000 | 5,000 |
| Growth | $199 | full | 5,000 | unlimited | 5,000 | 25,000 |
| Scale | $599 | full + AI | unlimited | unlimited | unlimited | unlimited |

### Agent Platform Compatibility

Nexus MCP server is compatible with:
- **Claude Desktop / Claude Code** — add mcp-server endpoint in MCP settings
- **Cursor** — add to .cursor/mcp.json or MCP settings
- **OpenClaw** — skill available on ClawHub: @karimsherifyehia/nexus
- **Any MCP-compatible agent** — protocol version 2025-03-26, Streamable HTTP transport

### Claude Desktop / Claude Code Config Example

```json
{
  "mcpServers": {
    "nexus": {
      "url": "https://lgwvoomgrwpsgpxwyaec.supabase.co/functions/v1/mcp-server",
      "headers": {
        "Authorization": "Bearer {your_jwt_token}"
      }
    }
  }
}
```

### Cursor Config Example (.cursor/mcp.json)

```json
{
  "mcpServers": {
    "nexus": {
      "url": "https://lgwvoomgrwpsgpxwyaec.supabase.co/functions/v1/mcp-server",
      "headers": {
        "Authorization": "Bearer {your_jwt_token}"
      }
    }
  }
}
```

## Blog

Recent posts: https://aiforstartups.io/blog

- "What an AI Agent Actually Does When You Give It Access to Your E-commerce Operations" (April 20, 2026)
  https://aiforstartups.io/blog/what-an-ai-agent-actually-does-ecommerce-ops

- "The Future of SaaS Isn't Selling to Humans. It's Selling to Their Agents." (April 15, 2026)
  https://aiforstartups.io/blog/the-future-of-saas-selling-to-agents

- "The Agent Pricing Model: Why We Made Our Free Tier Read-Only" (March 26, 2026)
  https://aiforstartups.io/blog/agent-pricing-model-read-only-free-tier

- "Why We Ditched 6 APIs and Built One MCP Server for Our Entire Ecommerce Stack" (March 26, 2026)
  https://aiforstartups.io/blog/one-mcp-server-entire-ecommerce-stack

- "How I Built an Agent-Native SaaS Platform in One Night" (March 25, 2026)
  https://aiforstartups.io/blog/agent-native-saas-one-night

## Contact

- Email: info@aiforstartups.io
- WhatsApp: https://wa.me/20104000090
- Twitter: @aiforstartups
- Dev.to: https://dev.to/karimsherifyehia
- Location: Cairo, Egypt