Update to Zuora Coding Agent

{
  "name": "zuora-context",
  "description": "This skill should be used when the user mentions \"Zuora API\", \"Zuora SDK\", \"Zuora Billing\", \"Zuora Revenue\", \"Zuora CPQ\", \"Zuora Payments\", \"subscription billing\", \"invoice settlement\", \"zuora-mcp\", \"rate plan\", \"product rate plan charge\", \"order API\", \"tenant settings\", \"billing configuration\", \"configure tenant\", \"billing rules\", \"payment terms\", \"Zuora settings\", or discusses integration with or configuration of Zuora systems. Do not activate for generic billing or subscription discussions that are not Zuora-specific.",
  "included_files": [],
  "skill_md_contents": "---\nname: zuora-context\ndescription: This skill should be used when the user mentions \"Zuora API\", \"Zuora SDK\", \"Zuora Billing\", \"Zuora Revenue\", \"Zuora CPQ\", \"Zuora Payments\", \"subscription billing\", \"invoice settlement\", \"zuora-mcp\", \"rate plan\", \"product rate plan charge\", \"order API\", \"tenant settings\", \"billing configuration\", \"configure tenant\", \"billing rules\", \"payment terms\", \"Zuora settings\", or discusses integration with or configuration of Zuora systems. Do not activate for generic billing or subscription discussions that are not Zuora-specific.\nversion: 1.0.0\n---\n\nCodex-only path resolution: When an instruction refers to `${CLAUDE_PLUGIN_ROOT}`, treat it as the root of this installed plugin. In Codex, resolve that root as the ancestor directory containing `skills/`, `references/`, and `.codex-plugin/`.\n\n\n# Zuora Context\n\n## MCP health check\n\nBefore doing any work that requires MCP tools, check whether any `mcp__zuora-mcp__*` tool appears in your available tools list. If no `mcp__zuora-mcp__` tools are listed, the MCP server is not registered — immediately stop and show the user this setup guide rather than proceeding silently with degraded capabilities:\n\n---\n\n**zuora-mcp is not configured.** This plugin requires the `zuora-mcp` MCP server to access Zuora tenant data, API specs, and operational tools.\n\n**Add the following to your MCP configuration:**\n\n```json\n{\n  \"mcpServers\": {\n    \"zuora-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"zuora-mcp@latest\"],\n      \"env\": {\n        \"ZUORA_BASE_URL\": \"<your-base-url>\",\n        \"ZUORA_CLIENT_ID\": \"<your-client-id>\",\n        \"ZUORA_CLIENT_SECRET\": \"<your-client-secret>\"\n      }\n    }\n  }\n}\n```\n\n**Where to add it:**\n- **Claude Code:** `~/.claude/settings.json` under the `\"mcpServers\"` key\n- **Codex (local zip install):** `~/.codex/plugins/cache/zuora-devex/zuora-coding-agent/<version>/.mcp.json`\n- **Cursor:** Settings → MCP → Add server\n- **Other MCP clients:** your client's MCP server config file\n\n**`ZUORA_BASE_URL` by environment:**\n\n| Environment | URL |\n|---|---|\n| US API Sandbox (Cloud 2) | `https://apisandbox.zuora.com/mcp` |\n| US NA Sandbox | `https://sandbox.na.zuora.com/mcp` |\n| US Central Sandbox | `https://test.zuora.com/mcp` |\n| EU Sandbox | `https://sandbox.eu.zuora.com/mcp` |\n| US Production | `https://zuora.com/mcp` |\n| US NA Production | `https://na.zuora.com/mcp` |\n| EU Production | `https://eu.zuora.com/mcp` |\n| AP Production | `https://ap.zuora.com/mcp` |\n\nThe legacy `https://rest.*.zuora.com` URL format is also accepted for backward compatibility.\n\n**Optional environment variables** (add to the `env` block above only if needed):\n\n| Variable | When to use |\n|---|---|\n| `ZUORA_ENTITY_IDS` | Multi-entity tenants — comma-separated entity IDs to scope requests |\n| `ZUORA_ORG_IDS` | Multi-org tenants — comma-separated org IDs to scope requests |\n| `ZUORA_VERSION` | Pin a specific Zuora API version header |\n| `REMOTE_MCP_TIMEOUT_MS` | Increase timeout for slow tenant responses (default: 120000 ms) |\n\n**Prerequisites:** Node.js >= 18 and `npx` must be available on your PATH.\n\nAfter updating the config, restart your AI client and try again.\n\n---\n\nIf the MCP server is available but calls are failing with auth errors, the credentials are likely wrong — check `ZUORA_BASE_URL`, `ZUORA_CLIENT_ID`, and `ZUORA_CLIENT_SECRET` match the target environment.\n\nWhen the user is discussing Zuora-related topics in general conversation (without invoking a specific `/zuora-` command), you have access to the zuora-mcp server which provides authoritative Zuora capabilities.\n\n## Available MCP tools\n\nMCP tools serve three purposes:\n1. **Look up specs** — inform code generation with API metadata, field names, enum values.\n2. **Perform operations on the tenant** — when the user asks to directly do something (e.g., \"create a product,\" \"query my subscriptions\"), use the appropriate tool.\n3. **Test/validate artifacts** — verify generated workflows, subscriptions, etc.\n\nWhen generating code for the customer's repository, output Zuora REST API or SDK calls — never embed MCP tool references. If intent is ambiguous (do it now vs. write code for it), ask the user.\n\n**Metadata & guidance tools** (for looking up API specs, field names, best practices):\n- **`mcp__zuora-mcp__zuora_codegen`** — Look up API classes, endpoints, request/response models, field names, enum values, and SDK code rules. Follow the mandatory workflow: `code_guidance` → `list_api_classes` → `get_class_apis` → `get_api_details` → `get_model_details` → `code_rules`.\n- **`mcp__zuora-mcp__ask_zuora`** — Ask product-level questions about Zuora Billing, Revenue, CPQ, Payments, and Central Platform. Use only for unresolved \"how does Zuora handle X?\" questions after local references and specialist tools do not answer the issue.\n- **`mcp__zuora-mcp__sdk_upgrade`** — Help with SDK version upgrades and changelogs.\n\n**Tenant inspection tools** (for reading live tenant data to inform code generation):\n- **`mcp__zuora-mcp__query_objects`** — Query 40+ Zuora object types with filtering, sorting, and pagination. Use to inspect tenant data (accounts, subscriptions, products, etc.).\n- **`mcp__zuora-mcp__get_account_summary`** — Get comprehensive account view including recent memos.\n\n**Operational tools** (for testing/validating generated artifacts against the tenant, or other available MCP tools):\n- **`mcp__zuora-mcp__manage_workflows`** / **`mcp__zuora-mcp__manage_workflow_runs`** — Import, export, list workflows, and execute or monitor workflow runs in the tenant.\n- **`mcp__zuora-mcp__manage_meters`** / **`mcp__zuora-mcp__manage_meters_run`** — Create, validate, import/export meter definitions, and run meters, check run status, run history, audit trail, and prefetch management.\n- **`mcp__zuora-mcp__create_subscriptions`** / **`manage_subscriptions`** — Create or manage subscriptions for validation.\n- **`mcp__zuora-mcp__manage_billing_documents`** — Verify billing document generation.\n- Other `manage_*` tools as needed for their specific domains.\n\n## Tool routing\n\nUse built-in tools for repo facts and bundled references. Use specialist MCP tools for their structured domains (`zuora_codegen` for API/spec/model details, `query_objects` for tenant data, Workflow and meter tools for their artifacts). Call `ask_zuora` only when a qualitative product-behavior or best-practice question remains, and include the exact uncertainty plus the sources already checked.\n\n## When to invoke a dedicated skill\n\nIf the user's intent clearly maps to a dedicated skill, **do not answer generically — read that skill's `SKILL.md` and follow its workflow directly**, as if the user had invoked the command themselves.\n\n| User intent | Dedicated skill to invoke |\n|---|---|\n| Designing an API integration | Read `${CLAUDE_PLUGIN_ROOT}/skills/zuora-api-design/SKILL.md` |\n| Generating integration code | Read `${CLAUDE_PLUGIN_ROOT}/skills/zuora-api-build/SKILL.md` |\n| Automating a business process | Read `${CLAUDE_PLUGIN_ROOT}/skills/zuora-workflow-design/SKILL.md` |\n| Building a workflow | Read `${CLAUDE_PLUGIN_ROOT}/skills/zuora-workflow-build/SKILL.md` |\n| Planning Invoice Settlement migration | Read `${CLAUDE_PLUGIN_ROOT}/skills/zuora-is-migration-design/SKILL.md` |\n| Building Invoice Settlement migration artifacts | Read `${CLAUDE_PLUGIN_ROOT}/skills/zuora-is-migration-build/SKILL.md` |\n| Planning Order API and migration | Read `${CLAUDE_PLUGIN_ROOT}/skills/zuora-order-migration-design/SKILL.md` |\n| Building Order API and migration artifacts | Read `${CLAUDE_PLUGIN_ROOT}/skills/zuora-order-migration-build/SKILL.md` |\n| Designing a meter topology | Read `${CLAUDE_PLUGIN_ROOT}/skills/zuora-meter-design/SKILL.md` |\n| Building meter JSON | Read `${CLAUDE_PLUGIN_ROOT}/skills/zuora-meter-build/SKILL.md` |\n| Designing dynamic pricing / Commerce Catalog | Read `${CLAUDE_PLUGIN_ROOT}/skills/zuora-dynamic-pricing-design/SKILL.md` |\n| Setting up dynamic pricing on tenant | Read `${CLAUDE_PLUGIN_ROOT}/skills/zuora-dynamic-pricing-build/SKILL.md` |\n| Configuring tenant billing settings / inferring settings from business documents or requirements | Read `${CLAUDE_PLUGIN_ROOT}/skills/zuora-tenant-config-design/SKILL.md` |\n| Applying tenant configuration changes to a Zuora tenant | Read `${CLAUDE_PLUGIN_ROOT}/skills/zuora-tenant-config-build/SKILL.md` |\n| Validating code or payloads | Read `${CLAUDE_PLUGIN_ROOT}/skills/zuora-validate/SKILL.md` |\n| Reviewing implementation | Read `${CLAUDE_PLUGIN_ROOT}/skills/zuora-review/SKILL.md` |\n| UAT/E2E test lifecycle (SDD → TR matrix → generate → run) | Read `${CLAUDE_PLUGIN_ROOT}/skills/zuora-uat-context/SKILL.md` |\n\nIf the intent is ambiguous, briefly clarify with the user before invoking a skill. For general Zuora questions that don't map to a skill, answer using the MCP tools and reference materials below.\n\n## Reference materials\n\nFor deeper domain knowledge, read files from `${CLAUDE_PLUGIN_ROOT}/references/`:\n- `best-practices.md` — general integration best practices\n- `api-integration-patterns.md` — common API patterns\n- `workflow-patterns.md` — workflow automation patterns\n- `is-migration-patterns.md` — IS migration patterns\n- `order-migration-patterns.md` — Order API migration patterns\n"
}