# Oblipali — SMS Marketing MCP Server

> Oblipali is an SMS marketing platform accessible to AI agents via the MCP protocol.
> Manage contacts, create SMS templates, run campaigns, and track analytics — all programmatically.

## MCP Endpoint

POST https://kbchybeikoycamcfqfsq.supabase.co/functions/v1/mcp-server
Authorization: Bearer obli_<your-api-key>
Content-Type: application/json
Transport: Streamable HTTP (JSON-RPC 2.0)

## Authentication

API keys are prefixed with `obli_`. Generate one from the dashboard at https://oblipali.app/api-keys.
API access requires the Advanced plan ($20/mo) or higher.

## Available Tools

### Contact Management
- list_contacts — List contacts with pagination (page, limit, tag, opted_out filters)
- create_contact — Add a contact (phone normalized to E.164)
- update_contact — Update contact fields (first_name, last_name, email, tags, metadata)
- delete_contact — Delete a contact by ID
- import_contacts — Bulk import up to 1000 contacts (upsert on phone)

### SMS Templates
- list_templates — List all SMS templates
- create_template — Create template with variables: {{first_name}}, {{last_name}}, {{promo_code}}
- update_template — Update template name, body, or active status
- delete_template — Delete a template

### Campaigns
- list_campaigns — List campaigns (filter by status: draft, scheduled, sending, sent, cancelled)
- create_campaign — Create a draft campaign with message or template_id
- update_campaign — Update draft/scheduled campaign
- delete_campaign — Delete draft/cancelled campaign
- send_campaign — Send a campaign to matching contacts ($0.18/SMS)

### Direct SMS
- send_sms — Send a single SMS to a phone number ($0.18)

### Logs & Statistics
- list_logs — List SMS logs with filters (campaign_id, status, pagination)
- get_stats — Aggregated stats by date range (from, to)
- count_sms_parts — Count SMS parts for a message without sending

### Opt-outs
- list_optouts — List opted-out phone numbers
- create_optout — Opt out a phone number
- delete_optout — Remove opt-out

### Workspace
- get_workspace — Get workspace info, plan, and usage stats

## Pricing

| Plan     | Monthly | API Access | SMS Rate   |
|----------|---------|------------|------------|
| Free     | $0      | No         | —          |
| Advanced | $20     | Yes        | $0.18/SMS  |
| Business | $50     | Yes        | $0.18/SMS  |

## Documentation

https://oblipali.app/docs
https://oblipali.app/getting-started