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) create documents, add contacts, create tasks and send emails.

Connect

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

{
  "mcpServers": {
    "epicurus-pro": {
      "url": "https://dev.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.
`update_email_thread`	write	Organise an email conversation in the Epicurus Pro inbox.
`find_email_recipients`	read	Look up people to email by name or email address: saved contacts first, then recent senders.
`list_team_chats`	read	Team Messages conversations for the key creator: one-to-one chats with colleagues and group chats, newest first, with unread counts and the last message..
`get_team_chat`	read	The latest messages in one Team Messages conversation.
`send_team_message`	write	Send a Team Messages chat message to a colleague in the same organisation, as the key creator.
`list_meeting_notes`	read	Meeting notes taken by the agent meeting taker, newest first: title, start and end time, summary and status.
`list_payment_cards`	read	Cards the key creator has saved to fund agent payments: brand, last 4 digits, expiry, personal or business and which is the default.
`list_agent_payments`	read	Purchases and bookings the agent has asked to pay for or paid, newest first: merchant, amount, status (pending, approved, paid, declined), type, how it was paid (business, personal or expense), expense claim status and whether a receipt was found.
`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).
`list_documents`	read	Documents the agent has made for the key creator (PDF, Word, PowerPoint, Excel), newest first, with download links that need a signed-in session..
`create_document`	write	Create a branded document for the key creator.
`list_document_styles`	read	Saved document styles (e.g.
`list_memorable_dates`	read	Upcoming birthdays and memorable dates (anniversaries, new jobs etc) for contacts in your organisation.
`add_memorable_date`	write	Save a memorable date against a contact.
`legal_research`	read	In-depth UK legal and HR research from authoritative sources (legislation.gov.uk, Find Case Law, BAILII, gov.uk, ACAS, HSE, ICO): statutes with sections, key cases with citations, guidance, time limits, next steps and source links.
`find_places`	read	Find real places (restaurants, hotels, shops, services) with rating, price, opening hours, phone, website and map link.
`list_email_watches`	read	Emails the key creator is waiting on a reply to, with chaser settings and status..
`list_mileage_trips`	read	Mileage trips for the key creator (recorded automatically by the phone app or added by hand): date, from, to, miles, purpose, type (business, personal or unreviewed), amount at HMRC rates and whether it is in a claim.
`list_mileage_claims`	read	Monthly mileage claims: month, trips, miles, amount and status (submitted, approved, rejected, paid).
`list_travel_expenses`	read	Travel and accommodation expenses for the key creator: hotels, trains, flights, taxis, chauffeurs, car hire and more, with how each was paid (expense = own card to claim back, company = company card, personal) and claim status.
`add_travel_expense`	write	Record a travel or hotel expense for the key creator.
`get_expense_report`	read	Expense report for a date range.
`list_dashboards_and_sites`	read	Dashboards, reports and web pages the agent has built: title, type, who can see it (private, secure or public), views, last updated and link..
`get_spending_policy`	read	The organisation spending policy: categories the agent always refuses to buy from or browse (e.g.

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