Model Context Protocol
The Suger MCP server puts your cloud GTM inside any AI assistant.
Connect Claude, Cursor, VS Code, or Windsurf to one remote endpoint and ask for what you need in plain language. 128 tools cover products, private offers, entitlements, metering, revenue, and co-sell — with no API key to manage.
Endpoint https://apiv2.suger.cloud/mcp
Which private offers expire in the next 30 days, and what are they worth?
Illustrative example. Results come from your own Suger account.
What it is
One endpoint between your assistant and your marketplace data
The Suger MCP server is a remote Model Context Protocol server that connects AI assistants to Suger data and services through natural language. It publishes 128 tools across 14 categories at a single HTTPS endpoint, so any MCP-compatible client can list products, build private offers, report usage, or pull a revenue report without a custom integration.
Because it speaks MCP rather than a bespoke plugin format, the same connection works across every client that implements the protocol — and it stays current as Suger adds tools, with nothing to redeploy on your side.
- Endpoint
- https://apiv2.suger.cloud/mcp
- Transport
- Remote MCP over HTTP
- Authentication
- OAuth 2.1 with PKCE
- Tools
- 128 across 14 categories
Not to be confused with the public MCP server for this website: suger.io runs a separate, read-only endpoint that only searches and reads marketing pages, documented on AI and agent access for suger.io. The server on this page reaches your actual Suger account.
How it works
Three steps from config file to first answer
Setup is a URL and a browser sign-in. There is no local server process, no gateway to host, and no secret to rotate.
Add the server
Point your MCP client at the remote endpoint with the one-line config for your tool. Nothing is installed and nothing runs locally.
Sign in once
The first connection opens a browser window for OAuth 2.1 sign-in with PKCE. No API key is created, pasted, or stored in a config file.
Ask in plain language
Your assistant discovers all 128 tools and calls the right ones — querying offers, reporting usage, or creating a co-sell referral.
Tool catalog
128 tools across 14 categories
The catalog mirrors the objects you already work with in the Suger console — products, offers, entitlements, buyers, usage, revenue, and co-sell. Every tool is documented with its parameters in the Suger MCP tool reference.
Organization
1 tool- ListOrganizations
Product Management
14 tools- ListProducts
- CreateProduct
- PublishProduct
- UpdateProductPricing
Offer Management
15 tools- CreateOffer
- QueryOffers
- CancelOffer
- ExtendPrivateOfferExpiryDate
Offer Sets
3 tools- CreateOfferSet
- ListOfferSets
Entitlement Management
21 tools- CreateEntitlement
- ApproveEntitlement
- AddEntitlementCredit
- UpdateEntitlementPriceModel
Buyer Management
11 tools- CreateBuyer
- ListBuyers
- CreateCreditWallet
Contact Management
11 tools- CreateContact
- UpdateContact
- AddContactToOffer
Metering & Usage
15 tools- ReportUsageRecordGroup
- CreateBillableMetric
- AggregateUsageData
Revenue & Reports
5 tools- GetRevenueReport
- ListRevenueRecords
- ListDailyRevenueRecords
Co-Sell
11 tools- CreateCosellReferral
- GetCosellDashboard
- SyncSingleReferral
Support Tickets
8 tools- CreateSupportTicket
- UpdateSupportTicket
- CloseSupportTicket
Notifications
6 tools- ListNotificationEvents
- UpdateNotificationConfigInfo
Operations
3 tools- ListOperationsV2
- GetOperationV2
API Management
2 tools- ListApiClients
Tool names shown are examples from each category, not the full list.
Connect your client
Copy one config, sign in once
Every client points at the same endpoint. Add the snippet below, restart the client, and approve the browser sign-in the first time it connects. Full walkthroughs live in the Suger MCP setup guide.
Claude Desktop
claude_desktop_config.json
{ "mcpServers": { "suger": { "url": "https://apiv2.suger.cloud/mcp" } } }Or add it without touching a file: Settings → Customize → Connectors → Add custom connector, name it Suger, and paste the endpoint URL.
Claude Code
Terminal
claude mcp add --transport http suger https://apiv2.suger.cloud/mcpThen run /mcp inside Claude Code to authenticate.
Cursor
.cursor/mcp.json
{ "mcpServers": { "suger": { "url": "https://apiv2.suger.cloud/mcp" } } }Project-scoped, so the whole repo picks up the same server.
VS Code (GitHub Copilot)
Terminal
code --add-mcp '{"type":"http","name":"suger","url":"https://apiv2.suger.cloud/mcp"}'Registers the server with Copilot's agent mode.
Windsurf & generic clients
MCP config
{ "mcpServers": { "suger": { "serverUrl": "https://apiv2.suger.cloud/mcp" } } }Uses serverUrl rather than url — the shape most non-Anthropic clients expect.
OAuth 2.1 with PKCE
Authorization runs through a browser sign-in on first connect, using the PKCE flow so no client secret is embedded anywhere.
No API key to manage
Your config file holds a URL and nothing else, so a shared repo or synced settings file never carries a credential.
Your account, your access
Every tool call is authorized by the Suger account you signed in with — the assistant does not get its own standing identity.
Co-sell over MCP
Run hyperscaler co-sell from the same conversation
Co-sell is one of the 14 categories, with 11 tools on the same endpoint — no second server to configure. An assistant can create a referral, pull the co-sell dashboard, or force a sync on a single referral while you are still writing the deal notes.
Suger publishes a dedicated guide for teams whose main MCP use case is co-sell.
Read the co-sell MCP guideCreateCosellReferral GetCosellDashboard SyncSingleReferral Three of the 11 co-sell tools. See also Suger co-sell automation.
Documentation
Everything on this page is documented in full at doc.suger.io.
MCP overview
What the server is, what it connects to, and when to reach for it.
Setup guide
Per-client install steps for Claude, Cursor, VS Code, and Windsurf.
Tool reference
Every one of the 128 tools, with parameters and expected responses.
Co-sell MCP guide
Referral creation, dashboard queries, and sync from an AI assistant.
Suger MCP server questions
Protocol, clients, permissions, and scope — answered.
What is MCP?
MCP (Model Context Protocol) is an open standard for connecting AI assistants to external systems. An MCP server publishes a set of tools, and any MCP-compatible client can discover those tools and call them on your behalf during a conversation.
Which AI clients work with the Suger MCP server?
Any MCP client that supports remote servers over HTTP. Suger documents setup for Claude Desktop, Claude Code, Cursor, VS Code with GitHub Copilot, and Windsurf. Other clients connect using the same generic server URL configuration.
How does authentication work?
The server uses OAuth 2.1 with PKCE. The first time your client connects, a browser window opens for you to sign in to Suger and approve access. There is no API key to create, copy, or rotate.
Is the Suger MCP server read-only or read-write?
Read-write. Alongside list and query tools, the catalog includes CreateOffer, ApproveEntitlement, UpdateProductPricing, CancelOffer, and CloseSupportTicket, so an assistant can change data in Suger. Every call is authorized by the Suger account that signed in.
What data can the Suger MCP server reach?
The 14 categories cover organizations, products, offers and offer sets, entitlements, buyers, contacts, metering and usage, revenue reports, co-sell referrals, support tickets, notifications, operations, and API clients — the same objects the Suger console works with.
Is there a separate MCP server for co-sell?
No. The 11 co-sell tools ship in the same server on the same endpoint. Suger publishes a dedicated co-sell MCP guide for teams whose primary use case is referral creation, dashboard queries, and referral sync.
Is this the same as the MCP server for the suger.io website?
No. This page covers the product MCP server for your Suger account data at apiv2.suger.cloud. suger.io separately runs a public, read-only MCP server that only searches and reads pages on this marketing site.
Bring Suger into your AI workflow
See the MCP server, the tool catalog, and the rest of the Suger platform on a live walkthrough.