# Mocean — how to use (mcp.ai)

Connect your Mocean account and use 6 tools for phone and SMS straight from your AI agent. Connect with your own API key. Mocean enables SMS, voice, and verification services, integrating messaging capabilities into applications for multifactor authentication or customer engagement.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_mocean?ms=1787295720000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `mocean_query_message_status_v2`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/mocean`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/mocean/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/mocean/query/message/status/v2` — Tool to query delivery status of an SMS message. Use after sending an SMS when you need to check its delivery success by msgid.
  - body: { mocean-msgid: string, mocean-api-key: string, mocean-api-secret: string, mocean-resp-format?: string }
- `POST https://api.mcp.ai/api/mocean/voice/dial/v2` — Tool to initiate an outbound voice call via Mocean API. Use when you need to place a call with a defined command flow.
  - body: { mocean-to: string, mocean-from?: string, mocean-command: string, mocean-event-url?: string, mocean-resp-format?: string }
- `POST https://api.mcp.ai/api/mocean/voice/download/recording/v2` — Tool to download a call recording. Use when you need to retrieve the recording audio for a completed call by its UUID.
  - body: { mocean-call-uuid: string }
- `POST https://api.mcp.ai/api/mocean/voice/hangup/v2` — Tool to hang up an active voice call. Use when you need to terminate an ongoing call by its call UUID immediately.
  - body: { mocean-api-key: string, mocean-call-uuid: string, mocean-api-secret: string, mocean-resp-format?: string }
- `POST https://api.mcp.ai/api/mocean/whats/app/send/message/v2` — Tool to send a WhatsApp message via Mocean API. Use when you need to send text, media, template, reaction, or interactive messages on WhatsApp.
  - body: { mocean-to: string, mocean-from: string, mocean-content: object, mocean-event-url?: string }
- `POST https://api.mcp.ai/api/mocean/whatsapp/incoming/webhook/v2` — Tool to receive and return the full incoming WhatsApp webhook payload. Use when you must capture raw webhook JSON (message_id, event_type, event_data) for downstream parsing.
  - body: { event_data: object, event_type: string, message_id: string }

## Example prompts
- "What can I do in Mocean?"
- "Show me a summary of my Mocean account"

## More
- Page: https://mcp.ai/mocean
- Agent spec (llms.txt): https://mcp.ai/mocean/llms.txt
- Postman collection: https://mcp.ai/mocean/postman.json