Skip to main content
Developers

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.

Endpointhttps://mcp.jelliu.coView Markdown →

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

  • jelliu_agents_listList your AI agents.
  • jelliu_agents_getGet one agent’s configuration.
  • jelliu_agents_createCreate a new agent (voice, language, prompt).
  • jelliu_agents_updateUpdate an agent’s fields.
  • jelliu_agents_deleteDelete an agent (auto-pauses its campaigns).
  • jelliu_agent_knowledge_listList an agent’s knowledge documents.
  • jelliu_agent_mcp_servers_listList external MCP servers assigned to an agent.

Campaigns

  • jelliu_campaigns_listList outreach campaigns.
  • jelliu_campaigns_getGet one campaign’s details.
  • jelliu_campaigns_createCreate a campaign with a schedule.
  • jelliu_campaigns_updateUpdate a campaign.
  • jelliu_campaigns_activateStart a campaign.
  • jelliu_campaigns_pausePause a running campaign.
  • jelliu_campaigns_deleteDelete a campaign.
  • jelliu_campaign_contacts_listList a campaign’s contacts.
  • jelliu_campaign_contacts_addAdd one contact to a campaign.
  • jelliu_campaign_contacts_bulk_addAdd up to 5,000 contacts at once.

Calls

  • jelliu_calls_listList calls with outcome and sentiment.
  • jelliu_calls_getGet a call with transcript and summary.
  • jelliu_calls_initiatePlace an outbound call (incurs cost).

Conversations

  • jelliu_conversations_listList omnichannel conversations.
  • jelliu_conversations_getGet a conversation thread.

Analytics

  • jelliu_analytics_overviewWorkspace-wide KPIs.
  • jelliu_analytics_overview_by_directionKPIs split inbound vs outbound.
  • jelliu_analytics_calls_per_dayDaily call-volume series.
  • jelliu_analytics_calls_by_hourHourly call distribution.
  • jelliu_analytics_sentiment_trendSentiment over time.
  • jelliu_analytics_top_campaignsBest-performing campaigns.
  • jelliu_analytics_agent_rankingAgent performance leaderboard.
  • jelliu_analytics_campaignMetrics for one campaign.

Messaging

  • jelliu_whatsapp_sendSend a WhatsApp message to a contact.
  • jelliu_email_sendSend an email to a contact.
  • jelliu_whatsapp_templates_listList approved WhatsApp templates.
  • jelliu_whatsapp_senders_listList WhatsApp sender numbers.

Integrations

  • jelliu_integrations_listList connected CRM integrations.
  • jelliu_integrations_getGet one integration’s config.
  • jelliu_webhooks_listList outbound webhooks.
  • jelliu_mcp_servers_listList external MCP servers in the workspace.

Billing (read-only)

  • jelliu_billing_subscriptionGet plan and subscription status.
  • jelliu_billing_usageGet usage and overage.
  • jelliu_billing_limitsGet tier limits.

Platform

  • jelliu_voices_listList available TTS voices.
  • jelliu_agent_templates_listList agent templates.
  • jelliu_notifications_listList in-app notifications.
  • jelliu_audit_listQuery 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):

{
  "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:

fullRead + write + operational tools (recommended for assistants that manage your workspace).
readRead-only tools (agents, campaigns, calls, analytics) — safe for reporting.
writeRead + 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.

Bring Jelliu into your AI workspace

Start with a free 15-minute trial, then connect your assistant in minutes.

Start 15-min TrialBook a Demo