Model Context Protocol
The Fours MCP server puts your cloud GTM inside any AI assistant.
Connect Claude, ChatGPT, Cursor, VS Code, or Windsurf to one remote endpoint and ask for what you need in plain language. 149 tools cover products, private offers, entitlements, metering, 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 Fours account.
What it is
One endpoint between your assistant and your marketplace data
The Fours MCP server is a remote Model Context Protocol server that connects AI assistants to Fours data and services through natural language. It publishes 149 tools across 17 categories at a single HTTPS endpoint, so any MCP-compatible client can list products, build private offers, report usage, or register a co-sell referral 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 Fours 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
- 149 across 17 categories
Not to be confused with the public MCP server for this website: fours.com runs a separate, read-only endpoint that only searches and reads marketing pages, documented on AI and agent access for fours.com. The server on this page reaches your actual Fours account.
Two directions for MCP
Fours works on both sides of MCP
MCP is a two-way street. Fours can be the server your AI clients call, and Fours AI can be the client that calls other teams' servers. This page covers the first direction; the second lives inside Fours AI and Insulin.
Your AI clients connect to Fours
Claude, ChatGPT, Cursor, VS Code, and Windsurf connect to the Fours MCP endpoint and act on your marketplace data — querying offers, reporting usage, or creating a co-sell referral. That is everything else on this page.
Connect your clientFours AI connects to other servers
Bring third-party tools into your agents: connect a provider from the catalog or paste a custom MCP server URL, authorize with OAuth, client credentials, or an API key, and Fours AI discovers and uses its tools. Each user connects their own servers with their own credentials.
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 149 tools and calls the right ones — querying offers, reporting usage, or creating a co-sell referral.
Tool catalog
149 tools across 17 categories
The catalog mirrors the objects you already work with in the Fours console — products, offers, entitlements, buyers, usage, and co-sell. Revenue records and reports stay in the Fours console. Every tool is documented with its parameters in the Fours MCP tool reference.
Organization
4 tools- ListOrganizations
Product Management
14 tools- ListProducts
- CreateProduct
- PublishProduct
- UpdateProductPricing
Offer Management
14 tools- CreateOffer
- QueryOffers
- CancelOffer
- ExtendPrivateOfferExpiryDate
Offer Sets
3 tools- CreateOfferSet
- ListOfferSets
Entitlement Management
23 tools- CreateEntitlement
- ApproveEntitlement
- AddEntitlementCredit
- UpdateEntitlementPriceModel
Buyer Management
10 tools- CreateBuyer
- ListBuyers
- CreateCreditWallet
Contact Management
9 tools- CreateContact
- UpdateContact
- AddContactToOffer
Metering & Usage
14 tools- ReportUsageRecordGroup
- CreateBillableMetric
- AggregateUsageRecordGroups
Reports
1 tool- ListUsageMeteringDailyRecords
Co-Sell
19 tools- CreateCosellReferral
- GetCosellDashboard
- SyncSingleReferral
Partner Relationship Management
15 tools- ListPrmPartners
- CreatePrmInvitation
- GetPartnerCommissions
Support Tickets
10 tools- CreateSupportTicket
- UpdateSupportTicket
- CloseSupportTicket
Notifications
6 tools- ListNotificationEvents
- UpdateNotificationConfigInfo
Operations
3 tools- ListOperationsV2
- GetOperationV2
API Management
2 tools- ListApiClients
Knowledge Search
1 tool- SearchKnowledge
Auditing
1 tool- QueryAuditingEvents
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 Fours 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 Fours, 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.
ChatGPT
Settings → Apps
https://apiv2.suger.cloud/mcpNo config file — in ChatGPT go to Settings → Apps, search for Fours (until the directory entry is renamed it may be listed under our former name, Suger), then click Connect and authorize access to your Fours workspace.
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 Fours 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 17 categories, with 19 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.
Fours 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 19 co-sell tools. See also Fours 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, ChatGPT, Cursor, VS Code, and Windsurf.
Tool reference
Every one of the 149 tools, with parameters and expected responses.
Co-sell MCP guide
Referral creation, dashboard queries, and sync from an AI assistant.
Fours 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 Fours MCP server? +
Any MCP client that supports remote servers over HTTP. Fours documents setup for Claude Desktop, Claude Code, ChatGPT, 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 Fours and approve access. There is no API key to create, copy, or rotate.
Is the Fours 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 Fours. Every call is authorized by the Fours account that signed in.
What data can the Fours MCP server reach? +
The 17 categories cover organizations, products, offers and offer sets, entitlements, buyers, contacts, metering and usage, daily metering reports, co-sell referrals, partner relationships and invitations, support tickets, notifications, operations, API clients, knowledge search, and audit events — the same objects the Fours console works with.
Is there a separate MCP server for co-sell? +
No. The 19 co-sell tools ship in the same server on the same endpoint. Fours publishes a dedicated co-sell MCP guide for teams whose primary use case is referral creation, dashboard queries, and referral sync.
Can Fours AI connect to external MCP servers? +
Yes — that is the other direction of MCP. Inside Fours AI and Insulin you can connect third-party MCP servers, either from a provider catalog or a custom server URL, authorizing with OAuth, client credentials, or an API key. Fours AI then discovers and uses those tools, and each user connects their own servers with their own credentials. See doc.suger.io/integrations/mcp/.
Is this the same as the MCP server for the fours.com website? +
No. This page covers the product MCP server for your Fours account data at apiv2.suger.cloud. fours.com separately runs a public, read-only MCP server that only searches and reads pages on this marketing site.
Bring Fours into your AI workflow
See the MCP server, the tool catalog, and the rest of the Fours platform on a live walkthrough.