Mocean Documentation MCP Server for AI Coding Agents

Read-only documentation

Give your coding agent accurate Mocean API context

Connect your AI coding agent to structured Mocean API documentation. The Mocean Documentation MCP Server helps agents discover operations and retrieve exact request and response APIs without leaving your development workflow.

Ask Mocean API questions in natural language

After connecting, ask your coding agent what you want to build. It can find the relevant operation, retrieve the complete API, and use that information to generate code in your project.

Example prompts

“Show me the Mocean endpoint and required fields for sending an SMS, then generate a server-side example.”
“How do I send an SMS OTP with Mocean Verify and check the code?”
“What JSON body does a WhatsApp template message require?”
“Create a webhook handler for Mocean SMS delivery reports.”

Quick start

Connect the Documentation MCP Server

Choose your MCP-compatible coding agent and add the public server URL. No Mocean account, API token, or additional Mocean AI developer tool is required.

Cursor

Open Cursor Settings, choose Tools & MCP, and add a remote MCP server using this configuration:

{
  "mcpServers": {
    "mocean-docs": {
      "url": "https://mcp.moceanapi.ai/mcp"
    }
  }
}
Claude Code
claude mcp add --transport http mocean-docs https://mcp.moceanapi.ai/mcp
Codex
codex mcp add mocean-docs --url https://mcp.moceanapi.ai/mcp
Other MCP clients

Add https://mcp.moceanapi.ai/mcp as a remote Streamable HTTP MCP server. Refer to your client’s documentation for its configuration format.

Focused documentation retrieval

The server exposes two tools. An agent first discovers relevant operations, then retrieves full details only for the operation it needs. This keeps the agent’s context focused while preserving access to complete APIs.

Discover

list_api_operations

Lists operation IDs, methods, paths, summaries, authentication requirements, and content types. It distinguishes REST calls from webhook routes your application hosts.

Inspect

get_api_operation

Retrieves the complete resolved API for one operation, including parameters, schemas, authentication, content types, statuses, and field descriptions.

MCP Server API Coverage

The Documentation MCP Server covers the public APIs currently available, including:

SMS WhatsApp WhatsApp templates Verify OTP Voice Number Lookup Account & pricing

What the server does—and does not do

The Documentation MCP Server gives your coding agent APIs while you build. Your application calls the Mocean REST APIs itself, using its own API token.

  • It retrieves structured public API documentation.
  • It does not execute API requests.
  • It does not receive or store your Mocean API token.
  • It does not replace the Mocean REST APIs.
  • Generated-code quality still depends on the coding agent, model, prompt, and surrounding project context.
  • Developers should review and test generated code before using it in production.

Troubleshooting

The MCP server does not appear in my agent

Confirm that the URL is exact, the client supports remote Streamable HTTP MCP servers, and your network can reach the endpoint. Restart the client if it does not reload MCP configuration automatically.

The agent answers without using a Mocean tool

Ask it explicitly to use the Mocean Documentation MCP Server. For example: “Use mocean-docs to retrieve the sendSms operation before writing code.”

The response contains only a list of operations

Ask the agent to retrieve the selected operation with get_api_operation. The list tool returns discovery information; the operation tool returns the full API.

Support and feedback

For Documentation MCP Server questions or feedback, contact Mocean support.