YCloud WhatsApp API

You run an MCP server that automatically exposes YCloud WhatsApp API endpoints to AI models, enabling seamless interaction with the YCloud WhatsApp API through an MCP client. This server handles API authentication, parameter validation, and HTTP communication, so you can focus on building conversational flows and automation with your AI assistant.

How to use

Start the MCP server locally and connect your MCP client to it. Provide your API key in the configured headers, and point the client to the server’s MCP endpoint. Use your AI model to issue requests that invoke any supported YCloud WhatsApp API endpoint through the MCP server. The server will validate inputs, attach authentication headers, and relay responses back to your model.

How to install

Prerequisites: Node.js v16.0.0 or higher, npm v7.0.0 or higher.

Clone the MCP server repository, install dependencies, and build the project.

# Clone the repository
git clone https://github.com/YCloud-Developers/ycloud-whatsapp-mcp-server.git
cd ycloud-whatsapp-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

Additional sections

Configuration and startup: you can run the server by setting environment variables for the API base URL and API headers, then starting via npm. The server uses the environment variables shown below and reads the OpenAPI spec to generate MCP tools automatically, exposing all YCloud API endpoints through MCP.

Environment variables you will configure include the base URL for the YCloud API and the API key header. The simplest startup pattern sets these variables inline and launches the server.

Claude desktop integration: you can wire the MCP server into Claude by adding a configuration entry that starts the local Node.js runtime for the server and passes the required environment variables, enabling Claude to invoke the MCP endpoints.

# Claude desktop configuration example (JSON snippet)
{
  "mcpServers": {
    "ycloud_whatsapp": {
      "command": "node",
      "args": ["path/to/ycloud-whatsapp-mcp-server/build/index.js"],
      "env": {
        "API_BASE_URL": "https://api.ycloud.com/v2",
        "API_HEADERS": "X-API-Key:your-api-key-here"
      }
    }
  }
}

Security and keys

Your YCloud API key must be provided to every API request. Include the key in the X-API-Key header as shown in the startup examples. Keep your API key secret and rotate it periodically as part of your security hygiene.