# Oblipali SMS — MCP Server

SMS marketing MCP server for AI agents. Manage contacts, create templates, run campaigns, send SMS, and track analytics — all via the Model Context Protocol.

## Quick Start

### 1. Connect your agent

```json
{
  "mcpServers": {
    "oblipali": {
      "url": "https://kbchybeikoycamcfqfsq.supabase.co/functions/v1/mcp-server",
      "transport": "streamable-http",
      "headers": {
        "Authorization": "Bearer obli_YOUR_API_KEY"
      }
    }
  }
}
```

### 2. Get your API key

1. Sign up at [oblipali.app](https://oblipali.app/signup)
2. Go to **API Keys** in the dashboard
3. Click **Create API Key** and copy it

### 3. Buy SMS credits

Go to [Credits & Usage](https://oblipali.app/billing) and buy a credit pack. No subscription — pay as you go.

| Pack | Credits | Price | Per SMS |
|------|---------|-------|---------|
| Starter | 50 | 9 EUR | 0.18 EUR |
| Growth | 200 | 30 EUR | 0.15 EUR |
| Pro | 500 | 65 EUR | 0.13 EUR |
| Scale | 1000 | 120 EUR | 0.12 EUR |

Credits never expire.

## Available Tools (20)

### Contact Management
| Tool | Description |
|------|-------------|
| `list_contacts` | List contacts with pagination and filters (tag, opted_out) |
| `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 1,000 contacts (upsert on phone) |

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

### Campaigns
| Tool | Description |
|------|-------------|
| `list_campaigns` | List campaigns (filter by status) |
| `create_campaign` | Create a draft campaign with message or template |
| `update_campaign` | Update a draft/scheduled campaign |
| `delete_campaign` | Delete a draft/cancelled campaign |
| `send_campaign` | Send a campaign to matching contacts (costs 1 credit per SMS) |

### Direct SMS
| Tool | Description |
|------|-------------|
| `send_sms` | Send a single SMS to a phone number (costs 1 credit per SMS part) |

### Logs & Statistics
| Tool | Description |
|------|-------------|
| `list_logs` | List SMS logs with filters (campaign_id, status, pagination) |
| `get_stats` | Aggregated send stats by date range |
| `count_sms_parts` | Count SMS parts for a message without sending |

### Opt-outs
| Tool | Description |
|------|-------------|
| `list_optouts` | List opted-out phone numbers |
| `create_optout` | Opt out a phone number |
| `delete_optout` | Remove an opt-out |

### Workspace
| Tool | Description |
|------|-------------|
| `get_workspace` | Get workspace info, credit balance, and usage stats |

## Example

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "send_sms",
    "arguments": {
      "phone": "+33612345678",
      "message": "Hi! Your order is ready for pickup."
    }
  }
}
```

Response:
```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [{
      "type": "text",
      "text": "{\"ok\": true, \"phone\": \"+33612345678\", \"sms_parts\": 1, \"credits_remaining\": 49}"
    }]
  }
}
```

## Protocol

- **Transport**: Streamable HTTP (POST)
- **Format**: JSON-RPC 2.0
- **Auth**: Bearer token (`obli_xxx`)
- **Endpoint**: `https://kbchybeikoycamcfqfsq.supabase.co/functions/v1/mcp-server`

## Agent Discovery

- `https://oblipali.app/llms.txt` — LLM-readable overview
- `https://oblipali.app/.well-known/mcp.json` — MCP auto-discovery

## Links

- [Documentation](https://oblipali.app/docs)
- [Getting Started](https://oblipali.app/getting-started)
- [Dashboard](https://oblipali.app/dashboard)