Connect an agent
- 1. Create a key
Open Settings → AI Agents & MCP → Create API Key. Choose the smallest permission that supports the intended work.
- 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. Configure the client
Use the Streamable HTTP endpoint and send the key as a Bearer token. A local stdio bridge is also available.
- 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
| Permission | Allows |
|---|---|
| READ | Inspect connections, apps, products, prices, matrices, deployments, history, and territories. |
| PREPARE | Create previews, calculate changes, and validate proposed rows without provider writes. |
| WRITE | Stage an apply request for human confirmation. It cannot bypass approval. |
Available tools
| Tool | Permission | Purpose |
|---|---|---|
| get_connected_platforms | READ | List connected providers and status. |
| get_apps / get_products | READ | List workspace apps and recurring products. |
| get_current_prices / get_pricing_matrix | READ | Read stored prices, groups, multipliers, and rows. |
| compare_platform_prices | READ · Partial | Compare normalized records heuristically. |
| run_pricing_audit | READ | Find missing coverage or inconsistent data. |
| create_pricing_preview / calculate_price_changes | PREPARE | Simulate pricing and return deltas. |
| validate_price_changes | PREPARE | Validate up to 250 proposed rows. |
| apply_price_changes | WRITE | Stage a deployment and return CONFIRMATION_REQUIRED. |
| get_deployments / get_pending_confirmations | READ | Read deployment and approval status. |
| get_price_history / get_supported_territories | READ | Read audit and territory metadata. |