MCP Server Documentation

Complete reference for the Oblipali MCP tools. 23 tools available via Streamable HTTP (JSON-RPC 2.0).

Connection

MCP Endpoint

POST https://kbchybeikoycamcfqfsq.supabase.co/functions/v1/mcp-server
Authorization: Bearer obli_your_api_key
Content-Type: application/json

Contacts

contacts.list List contacts with pagination and filters page?, limit?, tag?, opted_out?

contacts.create Add a contact (phone normalized to E.164) phone*, first_name?, last_name?, email?, tags?, metadata?

contacts.update Update an existing contact id*, first_name?, last_name?, email?, tags?, metadata?

contacts.delete Delete a contact id*

contacts.import Bulk import up to 1,000 contacts (upsert on phone) contacts*: [{phone, first_name?, ...}]

SMS Templates

templates.list List all SMS templates (none)

templates.create Create template with {{first_name}}, {{last_name}}, {{promo_code}} name*, body*

templates.update Update a template id*, name?, body?, is_active?

templates.delete Delete a template id*

Campaigns

campaigns.list List campaigns status?

campaigns.create Create a draft campaign name*, message?, template_id?, scheduled_at?, target_filter?

campaigns.update Update a draft campaign id*, name?, message?, ...

campaigns.delete Delete a draft/cancelled campaign id*

campaigns.send Send a campaign (costs credits) id*

Direct SMS

sms.send Send a single SMS (costs credits per destination) phone*, message*

sms.count_parts Count SMS parts without sending message*

sms.pricing Get pricing for a phone or country phone?, country?

Logs & Stats

logs.list List SMS logs with filters page?, limit?, campaign_id?, status?

stats.get Aggregated stats by date range from?, to?

Opt-outs

optouts.list List opted-out phones (none)

optouts.create Opt out a phone phone*, reason?

optouts.delete Remove opt-out phone*

Workspace

workspace.get Get workspace info and credit balance (none)

Example

Send an SMS via tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "sms.send",
    "arguments": {
      "phone": "+33612345678",
      "message": "Hi! Your order is ready."
    }
  }
}

Pricing

Pay-as-you-go with prepaid credits. No subscription.

Pack	Credits	Price
50 credits	50	6 EUR
500 credits	500	45 EUR
1,000 credits	1,000	80 EUR

Credits never expire. Use sms.pricing to check cost per destination.