otherapi_key

Mocean

Mocean enables SMS, voice, and verification services, integrating messaging capabilities into applications for multifactor authentication or customer engagement

Verdict

Mocean brings SMS and voice messaging into Switchy, letting teams send texts, make calls, and check delivery status without leaving the workspace. An @mention to Mocean typically sends a one-off message, retrieves campaign metrics, or checks account balance. Marketing teams running SMS campaigns and support teams coordinating urgent customer contact get the most use. Setup requires a Mocean API key and secret, which you generate from your Mocean dashboard. No OAuth complexity, but you'll need to manage credentials securely.

Common use cases

  • Send appointment reminders to customers via SMS
  • Notify on-call engineers of critical alerts
  • Check campaign delivery rates during standup
  • Broadcast flash sale announcements to subscriber list
  • Verify account balance before bulk send

Integration

Vendor
Mocean
Category
other
Auth
API_KEY
Composio slug
mocean

Tools

Per-tool listings haven't synced yet for Mocean. The connection itself works - your Space can already @-mention it. Tool descriptions will fill in on the next Composio ingest.

Setup

Setup guide

  1. 11. Log into your Mocean account at dashboard.moceanapi.com and navigate to API Keys under Settings. 2. Generate a new API key pair — you'll receive both an API key and an API secret; copy both immediately as the secret won't display again. 3. In Switchy, open your workspace settings and click Integrations, then find Mocean in the list. 4. Paste your API key into the 'API Key' field and your API secret into the 'API Secret' field, then click Connect. 5. Switchy will verify the credentials by pinging Mocean's balance endpoint. 6. Once connected, open any Space and type '@Mocean check my account balance' to confirm the integration responds. 7. You can now @mention Mocean in any message to send SMS, retrieve delivery reports, or query your remaining credits.

What teammates see: by default, memories from Mocean are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.

Works well with

Top models

Compatibility data appears once enough Spaces have used this MCP together with a given model.

How Switchy teams use it

Not enough Spaces yet to publish anonymised usage stats (we require ≥ 50 Spaces per week).

Starter prompts

Send Customer Reminder

@Mocean send an SMS to +1234567890 with the message 'Your appointment is confirmed for tomorrow at 2pm. Reply CANCEL to reschedule.'
Open in a Space →

Check Delivery Status

@Mocean get the delivery status for message ID 98765. Show me whether it was delivered, failed, or is still pending.
Open in a Space →

Query Account Balance

@Mocean check my current account balance and tell me how many SMS credits I have left.
Open in a Space →

Broadcast Flash Sale

@Mocean send the message 'Flash sale: 30% off all items today only. Use code FLASH30 at checkout.' to the following numbers: +1234567890, +0987654321, +1122334455.
Open in a Space →

Verify Number Format

@Mocean verify that +1234567890 is a valid phone number format for SMS delivery.
Open in a Space →

Example outputs

Illustrative - representative of the model's voice and quality, not literal recordings.

Prompt

@Mocean send an SMS to +60123456789 with the message 'Your verification code is 847291. Valid for 10 minutes.'

Output

SMS sent successfully via Mocean. Message ID: msg_9k3j2h1f. Delivered to +60123456789 at 2024-01-15 14:32:07 UTC. Character count: 62 (1 segment). Delivery status: accepted by carrier. You can track this message in your Mocean dashboard under outbound messages.

Notes

This example shows the core SMS delivery capability. Requires valid API credentials with send permissions and sufficient account balance. Messages are charged per segment (160 characters for GSM-7, 70 for Unicode). Delivery confirmation is carrier-dependent and may take seconds to minutes.

Prompt

@Mocean check the delivery status for message ID msg_9k3j2h1f and show me the current account balance

Output

Message msg_9k3j2h1f status: delivered at 2024-01-15 14:32:19 UTC (12 seconds after submission). Recipient confirmed receipt. Your Mocean account balance: $47.35 USD. This covers approximately 2,840 standard SMS segments at current rates. Last top-up was $50.00 on 2024-01-10.

Notes

Demonstrates read operations for message tracking and account monitoring. Delivery timestamps depend on carrier response speed. Balance checks help prevent service interruption during high-volume campaigns. Status updates may lag by 30-60 seconds for some carriers in certain regions.

Prompt

@Mocean analyze the last 50 outbound messages and summarize delivery success rate by country code, flagging any patterns in failed deliveries

Output

Analyzed 50 messages sent between 2024-01-10 and 2024-01-15. Overall delivery rate: 94% (47 delivered, 3 failed). Breakdown by country: Malaysia (+60): 38 sent, 37 delivered (97.4%). Singapore (+65): 12 sent, 10 delivered (83.3%). Failed messages: 2 to Singapore numbers showed 'invalid number' errors, 1 Malaysia message timed out after 48 hours. Recommendation: validate Singapore numbers against current registry before sending.

Notes

Combines Mocean's message history retrieval with AI analysis to surface operational insights. Useful for troubleshooting delivery issues or optimizing send strategies. Requires access to message logs (typically retained 30-90 days). Analysis quality depends on sample size and time range selected.

Use-case deep-dives

SMS notification pipeline for ops teams

When you need transactional SMS without building your own gateway

A 6-person DevOps team needs to send alert texts when deployments fail or servers go down. They don't want to manage Twilio credentials across three environments or write retry logic for SMS delivery. Mocean handles the message queue and delivery receipts through a single API key. The trade-off: you're locked into Mocean's rate limits and regional coverage, so if you're sending 10k+ texts a day or need guaranteed delivery in Southeast Asia, verify their SLA first. For most small teams sending a few hundred operational alerts a month, the simplicity wins. If your alert volume is under 500 texts per day and you want one less vendor to audit, Mocean keeps the pipeline clean.

Customer onboarding verification texts

When your signup flow needs two-factor codes without telecom overhead

A 4-person SaaS startup is adding phone verification to their signup form. They need to send a 6-digit code, wait 90 seconds, maybe resend once. They don't need voice calls, don't need to parse replies, and don't want to negotiate carrier contracts. Mocean's API key auth means the backend engineer can wire this up in an afternoon without touching OAuth or webhook signatures. The constraint: if you later want to handle inbound SMS replies or build a full conversational flow, you'll outgrow this fast. For one-way verification codes sent to under 1,000 users a week, Mocean does the job without the Twilio learning curve. If you're just checking that the phone number is real, this is the right scope.

Event reminder broadcasts for community managers

When you're sending batch reminders and need delivery tracking

A 3-person nonprofit runs monthly meetups and wants to text 200 RSVPs the day before each event. They need to know which messages bounced so they can follow up by email. Mocean's delivery receipts let them log failures without building a webhook listener or polling a status endpoint. The catch: if you're personalizing each message with custom fields pulled from Airtable or need to throttle sends across time zones, you'll write that logic yourself—Mocean doesn't template or schedule. For straightforward batch sends under 500 recipients where you just need proof of delivery, the API key model keeps it simple. If your list is static and your message rarely changes, this handles the last mile.

Frequently asked

What does the Mocean MCP do in Switchy?

The Mocean MCP connects Switchy to Mocean's SMS and voice messaging platform. Your team can send transactional SMS, verify phone numbers, or trigger voice calls directly from AI workflows without writing API code. It's designed for teams that need programmatic messaging as part of customer onboarding, alerts, or two-factor auth flows.

Do I need a Mocean account to use this MCP?

Yes. You'll need an active Mocean account and an API key from your Mocean dashboard. The MCP uses API key authentication, so there's no OAuth flow — just paste your key into Switchy's connection settings. Make sure the key has permissions for the messaging services you plan to use.

Can the Mocean MCP receive incoming SMS or calls?

No. This MCP is outbound-only — it sends messages and initiates calls. If you need to handle incoming SMS or voice events, you'll need to configure webhooks directly in your Mocean dashboard and route them to your own server or automation platform. Switchy doesn't act as a webhook receiver for Mocean.

How is this different from calling the Mocean API directly?

The MCP wraps Mocean's API so your team can trigger SMS or voice actions from natural language prompts inside Switchy. You skip writing HTTP requests, handling rate limits, or managing credentials in code. If you already have a developer building custom integrations, the raw API gives you more control.

Does using the Mocean MCP count against my Switchy plan limits?

MCP connections don't count as seats, but every message sent via Mocean consumes credits from your Mocean account, not Switchy. Switchy doesn't charge per-message fees. If your team sends high volumes, monitor your Mocean billing dashboard to avoid surprise overages.

Data last verified 608 hours ago.Sources aggregated hourly to weekly. See docs/architecture/model-directory.md.