Skip to navigation
ExtensibilityMediation

Zuora Mediation Model Context Protocol

View as Markdown

Learn how Mediation MCP helps you design, operate, monitor, and troubleshoot Mediation pipelines through an AI assistant.

Zuora Mediation turns raw usage events into billable usage records for Zuora Billing. A meter is a streaming pipeline with the following structure:

SOURCE → PROCESSOR(s) → SINK

Mediation MCP exposes Mediation through an AI assistant that supports the Model Context Protocol (MCP). You can use an MCP-compatible client, such as Cursor, Claude Desktop, Claude Code, VS Code Copilot Chat, or Gemini CLI. The assistant uses the same OAuth identity and permissions as the Mediation user interface and REST APIs.

It can help you perform the following tasks:

  • Discover meters and read meter definitions.
  • Validate task graphs before you save them.
  • Create or update meters after you approve the change.
  • Start and stop meter runs.
  • Check run status and history.
  • Review run summaries and operator summaries.
  • Browse error and sample audit records.
  • Create and download audit exports.

Mediation MCP capabilities

You want toMediation MCP helps you
See what meters existList and read meter definitions.
Design or change a pipelineValidate task graphs and create or update meters after approval.
Operate a meterStart and stop runs and check status and history.
Investigate failuresRetrieve error audit samples and operator summaries.
Reconcile data offlineCreate audit export jobs and download the results.

Mediation MCP tools

Mediation MCP exposes three tools with a total of 40 operations:

ToolOperationsPurposeStart with
manage_meters19Manage event schemas, event stores, connections, and meter task graphs.meter_guidance
manage_meters_run14Manage the run lifecycle, status, history, summaries, prefetch, and ingestion helpers.run_guidance
manage_meters_audit7Browse error and sample audit records and manage bulk export jobs.audit_guidance

Each call includes an operation name and its parameters. Do not invent parameters. Use the applicable guidance operation or the tool schema.

Mediation MCP is part of the broader Zuora Developer MCP, also called Zuora Remote MCP or DevX Remote MCP. Billing tools, such as manage_usage, use the same server but are not Mediation pipeline tools.

You can also ask the MCP server about its capabilities. For example, ask, “What can I do with manage_meters?”