Developers

MCP for AI agents

Connect your own systems and AI agents to Epicurus Pro with a simple REST API and a Model Context Protocol (MCP) server.

What is it?

The Model Context Protocol lets AI assistants call tools in other systems. Epicurus Pro runs an MCP server over Streamable HTTP, so an agent like Claude, ChatGPT or Cursor can read your contacts, emails, calls and tasks, and (with a write key) add contacts, create tasks and send emails.

Connect

Server URL: https://fraser.epicurus.pro/api/mcp
Auth: Authorization: Bearer ep_live_your_key

{
  "mcpServers": {
    "epicurus-pro": {
      "url": "https://fraser.epicurus.pro/api/mcp",
      "headers": { "Authorization": "Bearer ep_live_your_key" }
    }
  }
}

Tools

Tool	Access	What it does
`get_credit_balance`	read	Your organisation's plan and current credit balance..
`list_entities`	read	The locations in your group, with people counts..
`list_team_members`	read	Your team: roles, super admin and owner flags, entities, 2FA, invite status and last sign-in.
`get_team_member`	read	Full audit of one team member: details, roles, entities, 2FA devices, signed-in devices, failed sign-ins and recent activity..
`invite_team_member`	write	Invite someone to your team with one or more roles (role keys or names, e.g.
`list_contacts`	read	Search your shared contact book (customers, colleagues and partners).
`get_contact`	read	One contact with phones, all email addresses, owner, creator, linked companies, recent emails and call/SMS/WhatsApp logs..
`list_companies`	read	Search your companies.
`list_email_threads`	read	Email conversations sent or received through Epicurus Pro, newest first, with unread counts and tracking.
`get_email_thread`	read	Every message in one email conversation, with delivery, open and click events..
`get_phone_usage`	read	Phone numbers on the account, call minutes used and available this month, and whether minutes top up automatically..
`list_comm_logs`	read	Logged calls, SMS and WhatsApp messages for a contact or company: date, time, who, direction, outcome, note, duration and AI call summary.
`get_org_audit_log`	read	Organisation-wide audit log: who did what, when, from which IP and location.
`get_billing_status`	read	Your plan, billing interval, status, current period, next bill date and amount, cancellation and account credit..
`add_contact`	write	Add a person to your contact book, optionally linked to a company.
`log_communication`	write	Log a call, SMS or WhatsApp against a contact or company.
`send_email`	write	Send an email to a contact from Epicurus Pro, as the key creator.
`list_tasks`	read	The key creator's tasks: follow-ups the AI pulled from their calls and tasks created by the team.
`get_task`	read	One task with its linked contact, company, source call and every note..
`get_call`	read	One logged call or message with duration, transcript, AI summary and the follow-up tasks created from it..
`list_phone_numbers`	read	Phone numbers on your account: number, type (mobile or landline), who it is assigned to, team line flag and capabilities..
`create_task`	write	Create a task linked to a contact or company.
`add_task_note`	write	Add a note to one of the key creator's tasks.
`complete_task`	write	Mark one of the key creator's tasks as done.
`search_help`	read	Search the Epicurus Pro help centre for how-to articles (settings, billing, invites, 2FA, calling, mailboxes and more)..
`list_support_tickets`	read	Support tickets raised by the key creator, newest first, with status.
`get_support_ticket`	read	One of the key creator's support tickets with every message from them and the Epicurus Pro team..
`raise_support_ticket`	write	Raise a support ticket to the Epicurus Pro team as the key creator.
`get_mailbox_settings`	read	The key creator's connected mailbox (Microsoft or Google): address, status, last sync and which emails are brought into Epicurus Pro (sync_mode: replies, contacts or all)..
`set_mailbox_sync_mode`	write	Choose which emails the key creator's mailbox brings into Epicurus Pro: replies (only replies to Epicurus Pro emails), contacts (anything with people in their contacts) or all (everything; non-contact mail is private to them).

Write tools only appear for read + write keys. Tools never delete data or change billing.