Zuora Developer MCP (Model Context Protocol) – Alpha Preview

The Zuora Developer MCP Server provides an AI-powered developer experience for building Zuora integrations. It implements the Model Context Protocol (MCP), enabling developers to:

• Generate production-grade code snippets using the Zuora SDK.
• Discover, explore, and analyze APIs and data models.
• Perform guided SDK upgrades across multiple languages (Java, Python, Node.js, C#) within their preferred IDEs via MCP-compatible clients.

This repository hosts an early alpha version of the Zuora Developer MCP.

✨ Features

Currently, Zuora Developer MCP includes three tools (more will be added over time):

• zuora_codegen: Generate integration code using the Zuora SDK.
• ask_zuora: Answer product questions in natural language.
• sdk_upgrade: Assist in upgrading the Zuora SDK in any supported language project.
• query_objects: Retrieve objects from a Zuora tenant efficiently and in a consistent manner.
• create_product: Create products in Zuora with approval policy enforced.

🔐 Prerequisites

• Node.js and npm installed on your local machine.
• An IDE that supports MCP configuration (e.g. Cursor, Windsurf).

🚀 Quick Start

To configure the Zuora Developer MCP in a client like Claude Desktop, Cursor, or Windsurf, add the following to your MCP config:

Note:

• Environment variables are required for ask_zuora and optional for other tools. You can find your BASE_URL here.

• To use a specific version, specify it like zuora-mcp@0.0.1-alpha.23 in the args array

{
  "mcpServers": {
    "zuora-developer-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "zuora-mcp"
      ],
      "env": {
        "BASE_URL": "{baseUrl}",
        "ZUORA_CLIENT_ID": "{clientId}",
        "ZUORA_CLIENT_SECRET": "{clientSecret}"
      }
    }
  }
}

For detailed setup guides, see:

• Claude Desktop
• Cursor
• Windsurf

📌 Important: The example above uses npx to run the MCP server. Make sure the zuora-mcp package is published or installed locally as needed.

Add the MCP rules to Cursor's User Rules. See cursor_rules.md for details.

📘 Changelog

0.0.1-alpha.23

• Correct broken Cursor link in README
• Correct broken Cursor rule link in README

0.0.1-alpha.22

• Addressed an issue causing the query_objects tool to miss results under certain conditions.

0.0.1-alpha.21

• Added query_objects and create_product to support executing user requests against remote endpoints (requires valid BASE_URL and ZUORA_CLIENT).
• Added zuora_approval tool to ensures all write operations comply with the enforced approval policy. To disable approval, set the environment variable APPROVAL_ENABLED="false".
• Upgraded Java/Python/Node.js SDKs to version 3.9.0 and C# SDK to version 1.1.0
• Fixed cURL issue caused by uppercase naming.

0.0.1-alpha.20

• Added curl support - Generate accurate curl commands with proper parameters, headers, and authentication
• Enhanced API details with HTTP information - Include HTTP method, path, required headers, and environment-specific base URLs
• Improved security for OAuth token generation - Secure credential handling with environment variable support
• Refactored code architecture - Cleaner separation between SDK and curl-specific processing
• Enhanced caching system - Optimized performance for all language types including curl

0.0.1-alpha.19

• Enhanced API knowledge base with Zuora environments and object query operators
• Upgraded Java/Python/Node.js SDKs to version 3.8.0 and C# SDK to version 1.0.0
• Added Cursor workspace rules for MCP-first, SDK-compliant code generation
• Added language parameter support to telemetry signals for better analytics

0.0.1-alpha.18

• Added Cursor MCP install link for easier setup.

0.0.1-alpha.17

• Improved documentation for clarity and completeness.
• Enhanced API metadata for better accuracy and context.

0.0.1-alpha.16

• Fixed several bugs in API resources.
• Added telemetry event tracking.

0.0.1-alpha.15

• Upgraded the SDK to version 3.7.0 and the C# SDK to version 1.0.0-beta.6.
• Improved SDK upgrade support across all languages with detailed change logs.

0.0.1-alpha.14

• Enhanced API detail responses to include request and response schemas.
• Added support for passing multiple model names to getModelDetail.