# Jelliu MCP Server

Connect your AI assistant to Jelliu’s agent, campaign and analytics capabilities through the Model Context Protocol (MCP) — operate your whole workspace from a conversation.

**Endpoint:** `https://mcp.jelliu.co`

## What is the Jelliu MCP Server?

The Jelliu MCP Server is a hosted integration that lets AI assistants like Claude, ChatGPT and Cursor operate your Jelliu workspace directly inside your conversation. Built on the open Model Context Protocol standard, it exposes Jelliu’s agents, campaigns, contacts, calls, messaging and analytics as tools — no dashboard switching required. It authenticates with a Jelliu API key, so the assistant acts strictly within your workspace and your permissions.

## What can you do with it?

The server exposes 45 tools across nine areas. Read tools are always available; write and operational tools require a full-scope API key.

### Agents

| Tool | Description |
| --- | --- |
| `jelliu_agents_list` | List your AI agents. |
| `jelliu_agents_get` | Get one agent’s configuration. |
| `jelliu_agents_create` | Create a new agent (voice, language, prompt). |
| `jelliu_agents_update` | Update an agent’s fields. |
| `jelliu_agents_delete` | Delete an agent (auto-pauses its campaigns). |
| `jelliu_agent_knowledge_list` | List an agent’s knowledge documents. |
| `jelliu_agent_mcp_servers_list` | List external MCP servers assigned to an agent. |

### Campaigns

| Tool | Description |
| --- | --- |
| `jelliu_campaigns_list` | List outreach campaigns. |
| `jelliu_campaigns_get` | Get one campaign’s details. |
| `jelliu_campaigns_create` | Create a campaign with a schedule. |
| `jelliu_campaigns_update` | Update a campaign. |
| `jelliu_campaigns_activate` | Start a campaign. |
| `jelliu_campaigns_pause` | Pause a running campaign. |
| `jelliu_campaigns_delete` | Delete a campaign. |
| `jelliu_campaign_contacts_list` | List a campaign’s contacts. |
| `jelliu_campaign_contacts_add` | Add one contact to a campaign. |
| `jelliu_campaign_contacts_bulk_add` | Add up to 5,000 contacts at once. |

### Calls

| Tool | Description |
| --- | --- |
| `jelliu_calls_list` | List calls with outcome and sentiment. |
| `jelliu_calls_get` | Get a call with transcript and summary. |
| `jelliu_calls_initiate` | Place an outbound call (incurs cost). |

### Conversations

| Tool | Description |
| --- | --- |
| `jelliu_conversations_list` | List omnichannel conversations. |
| `jelliu_conversations_get` | Get a conversation thread. |

### Analytics

| Tool | Description |
| --- | --- |
| `jelliu_analytics_overview` | Workspace-wide KPIs. |
| `jelliu_analytics_overview_by_direction` | KPIs split inbound vs outbound. |
| `jelliu_analytics_calls_per_day` | Daily call-volume series. |
| `jelliu_analytics_calls_by_hour` | Hourly call distribution. |
| `jelliu_analytics_sentiment_trend` | Sentiment over time. |
| `jelliu_analytics_top_campaigns` | Best-performing campaigns. |
| `jelliu_analytics_agent_ranking` | Agent performance leaderboard. |
| `jelliu_analytics_campaign` | Metrics for one campaign. |

### Messaging

| Tool | Description |
| --- | --- |
| `jelliu_whatsapp_send` | Send a WhatsApp message to a contact. |
| `jelliu_email_send` | Send an email to a contact. |
| `jelliu_whatsapp_templates_list` | List approved WhatsApp templates. |
| `jelliu_whatsapp_senders_list` | List WhatsApp sender numbers. |

### Integrations

| Tool | Description |
| --- | --- |
| `jelliu_integrations_list` | List connected CRM integrations. |
| `jelliu_integrations_get` | Get one integration’s config. |
| `jelliu_webhooks_list` | List outbound webhooks. |
| `jelliu_mcp_servers_list` | List external MCP servers in the workspace. |

### Billing (read-only)

| Tool | Description |
| --- | --- |
| `jelliu_billing_subscription` | Get plan and subscription status. |
| `jelliu_billing_usage` | Get usage and overage. |
| `jelliu_billing_limits` | Get tier limits. |

### Platform

| Tool | Description |
| --- | --- |
| `jelliu_voices_list` | List available TTS voices. |
| `jelliu_agent_templates_list` | List agent templates. |
| `jelliu_notifications_list` | List in-app notifications. |
| `jelliu_audit_list` | Query the audit log. |

## Example use cases

Ask your assistant naturally — it picks the right tools.

- “Create a Spanish sales agent and launch a campaign for my product launch this week.”
- “How did my outbound calls perform yesterday? Show sentiment by agent.”
- “Add these 200 contacts to the Q3 retention campaign and activate it.”
- “Send a WhatsApp follow-up to the contacts that didn’t answer.”

## Setup

### For Claude, ChatGPT & Cursor

1. **Create an API key** — In Jelliu, go to Settings → API Keys and create a key with full scope.
2. **Add the connector** — In your AI client, add a custom MCP connector pointing at the URL below.
3. **Authenticate** — Paste your API key in the Authorization header as “Bearer jl_…”.
4. **Start working** — Ask your assistant to manage agents, campaigns, contacts and analytics naturally.

### For developers (direct integration)

Add the server to your client config (Claude Code, Cursor, or any MCP client):

```json
{
  "mcpServers": {
    "jelliu": {
      "type": "http",
      "url": "https://mcp.jelliu.co",
      "headers": { "Authorization": "Bearer jl_your_full_scope_key" }
    }
  }
}
```

The transport is stateless Streamable HTTP. Any MCP-compatible client works — pass the API key in the Authorization header.

## Authentication & scopes

Every request authenticates with a Jelliu API key (jl_…) sent in the Authorization header. The tools an assistant can see and use depend on the key’s scope:

| Scope | Access |
| --- | --- |
| `full` | Read + write + operational tools (recommended for assistants that manage your workspace). |
| `read` | Read-only tools (agents, campaigns, calls, analytics) — safe for reporting. |
| `write` | Read + non-admin writes. |

## Known limitations

- Credential management (creating or revoking API keys) is not available via MCP — use the dashboard.
- Billing purchases (checkout, minute packs, phone numbers) and data-erasure are not exposed — they stay in the dashboard.
- Rate limited — requests share your workspace’s per-minute API limits.
- Outbound calls and messages incur cost and act immediately; your assistant should confirm before sending.

## Privacy & security

- Scoped to your workspace — a key only ever touches the workspace it belongs to.
- Reuses Jelliu’s full security stack: role checks, validation, rate limits and an immutable audit log.
- Secure transport — all traffic is HTTPS/TLS encrypted.
- Revoke anytime — delete the API key in Settings to instantly cut off access.

## Support & feedback

Found a bug or have a request? Email us at mcp@jelliu.co — we read every message.

## About MCP

The Model Context Protocol (MCP) is an open standard for connecting AI assistants to external tools and services. Learn more at modelcontextprotocol.io.

## FAQ

### What is the Jelliu MCP Server?

A hosted Model Context Protocol server that lets AI assistants like Claude, ChatGPT and Cursor manage your Jelliu workspace — agents, campaigns, contacts, calls, messaging and analytics — from your conversation, authenticated with a Jelliu API key.

### How do I connect Claude or ChatGPT to Jelliu?

Create a full-scope API key in Settings → API Keys, then add a custom MCP connector in your client pointing at https://mcp.jelliu.co with the key in the Authorization header.

### Is it secure?

Yes. Every request authenticates with a scoped API key and reuses Jelliu’s role checks, input validation, rate limits and immutable audit log. All traffic is encrypted over HTTPS, and you can revoke a key at any time.

### What can the assistant do?

It exposes 45 tools across agents, campaigns, calls, conversations, analytics, messaging, integrations, billing (read-only) and platform utilities. Write and operational tools require a full-scope key.