NEW Let your AI agent preview price changes MCP
← All documentation

MCP and AI agents

Scale and lifetime plans can connect an MCP-compatible agent to inspect pricing, prepare calculations, and stage guarded changes through a workspace-scoped key.

Connect an agent

  1. 1. Create a key

    Open Settings → AI Agents & MCP → Create API Key. Choose the smallest permission that supports the intended work.

  2. 2. Copy it once

    The full rs_mcp_live_… secret is shown only at creation. RevenueStack stores its SHA-256 hash and a visible prefix.

  3. 3. Configure the client

    Use the Streamable HTTP endpoint and send the key as a Bearer token. A local stdio bridge is also available.

  4. 4. Review activity

    Inspect last use, activity, pending confirmations, and update or revoke access in Settings.

Connection details

Endpoint: https://app.revenuestack.app/api/mcp
Transport: Streamable HTTP / JSON-RPC
Header: Authorization: Bearer rs_mcp_live_••••••••

Permissions

PermissionAllows
READInspect connections, apps, products, prices, matrices, deployments, history, and territories.
PREPARECreate previews, calculate changes, and validate proposed rows without provider writes.
WRITEStage an apply request for human confirmation. It cannot bypass approval.

Available tools

ToolPermissionPurpose
get_connected_platformsREADList connected providers and status.
get_apps / get_productsREADList workspace apps and recurring products.
get_current_prices / get_pricing_matrixREADRead stored prices, groups, multipliers, and rows.
compare_platform_pricesREAD · PartialCompare normalized records heuristically.
run_pricing_auditREADFind missing coverage or inconsistent data.
create_pricing_preview / calculate_price_changesPREPARESimulate pricing and return deltas.
validate_price_changesPREPAREValidate up to 250 proposed rows.
apply_price_changesWRITEStage a deployment and return CONFIRMATION_REQUIRED.
get_deployments / get_pending_confirmationsREADRead deployment and approval status.
get_price_history / get_supported_territoriesREADRead audit and territory metadata.