Skip to main content

Overview

Connect AI assistants to your Suger data & services using natural language.


The Suger MCP Server lets AI agents and assistants work directly with your cloud marketplace data. Ask questions in natural language, automate repetitive tasks, and manage your multi-cloud business — all from the AI tools you already use.

It implements the Model Context Protocol (MCP), the open standard for connecting AI assistants to external data sources and actions.

Availability: All Suger pricing plans

MCP Server URL: https://apiv2.suger.cloud/mcp

Key Features

  • Multi-cloud marketplace management: Manage products, offers, entitlements, and buyers across AWS, Azure, and GCP Marketplace from a single interface.
  • OAuth 2.1 authentication: Secure, token-based access scoped to your organization. Your AI assistant can only perform actions you have permission to do.
  • 120+ tools: Covers the full Suger API surface — from creating offers to generating revenue reports.

Scenarios for Using the Suger MCP Server

Connect your AI assistant to Suger MCP and use natural language for tasks like:

  • "Create a private offer for Acme Corp on AWS with a 20% discount" — Draft and manage offers without switching to the Suger console.
  • "Show me all entitlements expiring in the next 30 days" — Get instant visibility into upcoming renewals.
  • "Generate a revenue report for Q4" — Pull billing and revenue data into your conversation.
  • "Report usage for entitlement ent-123" — Submit metering data directly from your development environment.
  • "What support tickets are open right now?" — Triage and update tickets from your editor.

What You Can Do

CategoryExamplesTools
Products & OffersCreate, publish, sync, and manage marketplace listings29
EntitlementsApprove, cancel, schedule renewals, manage terms and pricing19
Buyers & ContactsManage buyer records, credit wallets, link contacts22
Billing & RevenueInvoices, payments, refunds, revenue reports15
Metering & UsageReport usage, manage billable metrics, validate records15
SupportCreate, update, and resolve support tickets8
Operations & AuditingTrack operations, audit events, notifications8
Co-Sell & SearchPartner connections, global search, AI analytics4

For the complete tool reference, see Supported Tools.

Supported Clients

You can connect to the Suger MCP Server from popular AI assistants and code editors, including:

You can also build custom applications that connect to the Suger MCP Server. Any client that implements the MCP specification with OAuth 2.1 + PKCE is supported. Contact Suger support to register your client.

Security and Access Control

  • Authentication: OAuth 2.1 only. API keys and static tokens are not supported.
  • Organization scoping: Every tool call is scoped to the authenticated user's organization, ensuring complete data isolation.
  • Permission model: The MCP server respects your existing Suger permissions — it never grants broader access than what your account already has.

Rate Limiting

The MCP server shares rate limits with the Suger REST API. If your AI assistant makes many rapid tool calls, it may trigger rate limits. Space out requests or reduce batch sizes if you encounter throttling.

Frequently Asked Questions

Can I use API keys instead of OAuth? No. OAuth 2.1 is the only supported authentication method, ensuring secure, organization-scoped access.

Does this support write operations? Yes. You can create offers, manage entitlements, report usage, issue invoices, and more — not just read data. All write operations respect your account permissions.

What happens if my MCP client isn't on the supported list? Contact Suger support. We can evaluate and register your client as long as it implements the MCP specification with OAuth 2.1 + PKCE.

How is data isolated between organizations? The OAuth token determines your organization scope. All queries and mutations are restricted to your organization's data — there is no way to access another organization's resources through the MCP server.