Supported Tools

Full reference for all 149 tools available through the Suger MCP Server.

The Suger MCP Server exposes 149 tools that cover the public Suger API — from listing products and managing entitlements to running the entire co-sell referral lifecycle across AWS, Azure, GCP and Suger partner companies, and managing partner relationships and invitations. Your AI assistant automatically discovers available tools and their parameters when it connects. You can combine multiple tools in a single conversation to accomplish complex, multi-step workflows.

Organization (4)

Tool	Description	Example Prompt
`ListOrganizations`	List organizations	“Show my organizations”
`GetOrganizationLicensesAndServices`	Get the organization’s enabled services and quota limits	“What services and quotas does my org have?”
`GetOnboardingStatus`	Get the organization’s Get Started checklist — which steps are complete, with the reason for any that aren’t	“Which Get Started steps do we still need to finish?”
`UpdateOnboardingInfo`	Skip or un-skip Get Started steps, or dismiss the checklist, for the whole organization	“Skip the CRM step on our Get Started checklist”

UpdateOnboardingInfo replaces the whole skippedSteps list and applies to everyone in the organization, so have your assistant read the current list with GetOnboardingStatus, change it, and write it back in one go.

Product Management (14)

Tool	Description	Example Prompt
`ListProducts`	List products	“List all my products”
`ListProductsByPartner`	List products by cloud partner	“Show all AWS products”
`QueryProducts`	Query products with filters	“Find products with status PUBLISHED”
`GetProduct`	Get product details	“Get details for product prod-123”
`CreateProduct`	Create a new product	“Create a SaaS product for AWS Marketplace”
`CreateOrUpdateDraftProduct`	Save a draft product	“Save a draft product listing”
`UpdateProduct`	Update a product	“Update the description for my product”
`UpdateProductMetaInfo`	Update product metadata	“Update product metadata”
`UpdateProductPricing`	Update product pricing / terms	“Update pricing for product prod-123”
`UpdateProductPrice`	Update AWS or Azure product pricing in one unified request	“Update the unified pricing for product prod-123”
`UpdateProductFulfillmentUrl`	Set product fulfillment URL	“Set the fulfillment URL for prod-123”
`UpdateProductTargeting`	Replace the list of buyer AWS accounts allowed to see and subscribe to a Limited-visibility AWS SaaS listing	“Set the buyer allowlist on our limited AWS listing to accounts 111122223333 and 444455556666”
`PublishProduct`	Publish a product to marketplace	“Publish prod-123 to the marketplace”
`ListProductMeteringDimensions`	List metering dimensions	“Show metering dimensions for prod-123”

Offer Management (14)

Tool	Description	Example Prompt
`ListOffers`	List offers	“List all my offers”
`QueryOffers`	Query offers with filters	“Show active offers on AWS”
`GetOffer`	Get offer details	“Get details for offer off-123”
`GetOfferByExternalId`	Look up offer by external ID	“Find offer by external ID ext-456”
`CreateOffer`	Create an offer	“Create a private offer for buyer xyz”
`CreateOrUpdateDraftOffer`	Save a draft offer	“Save a draft offer”
`UpdateOfferMetaInfo`	Update offer metadata	“Update metadata for off-123”
`UpdateOfferPrice`	Add a new usage dimension to a released private offer	“Add a new pricing dimension to offer off-123”
`CancelOffer`	Cancel an offer	“Cancel offer off-123”
`ExtendPrivateOfferExpiryDate`	Extend offer expiry	“Extend the expiry date of off-123 by 30 days”
`SyncOffer`	Sync offer from cloud partner	“Sync off-123 from AWS Marketplace”
`SendOfferNotifications`	Notify offer contacts	“Send notification to contacts of off-123”
`GetOfferEula`	Get offer EULA	“Show the EULA for off-123”
`GetOfferResellerEula`	Get reseller EULA	“Get the reseller EULA for off-123”

Offer Sets (3)

Tool	Description	Example Prompt
`ListOfferSets`	List offer sets	“Show all offer sets”
`CreateOfferSet`	Create an offer set	“Create a new offer set”
`GetOfferSet`	Get offer set details	“Get offer set details”

Entitlement Management (23)

Tool	Description	Example Prompt
`ListEntitlements`	List entitlements	“List all entitlements”
`QueryEntitlements`	Query entitlements with filters	“Show entitlements expiring this month”
`GetEntitlement`	Get entitlement details	“Get entitlement ent-123”
`CreateEntitlement`	Create an entitlement	“Create an entitlement for buyer xyz”
`ApproveEntitlement`	Approve a pending entitlement	“Approve entitlement ent-123”
`CancelEntitlement`	Cancel an entitlement	“Cancel entitlement ent-123”
`ListEntitlementCancellationRequests`	List cancellation requests for an entitlement	“Show pending cancellation requests for ent-123”
`WithdrawEntitlementCancellationRequest`	Withdraw a cancellation request	“Withdraw the cancellation request for ent-123”
`ScheduleEntitlementCancellation`	Schedule future cancellation	“Schedule cancellation for ent-123 at end of term”
`UnscheduleEntitlementCancellation`	Remove scheduled cancellation	“Remove the scheduled cancellation for ent-123”
`GetEntitlementRenewalDraftOffer`	Get the pending draft renewal offer for an AWS entitlement, if there is one	“Show the draft renewal offer for ent-123”
`AdjustEntitlementRenewalUplift`	Reprice an AWS entitlement’s pending renewal offer to a different uplift within the agreement’s allowed range, saved as a draft or published to the buyer (publishing can’t be undone)	“Change the renewal uplift for ent-123 to 5% and keep it as a draft”
`OptOutEntitlementRenewal`	Stop an AWS entitlement from auto-renewing by expiring its pending renewal offer	“Opt ent-123 out of auto-renewal”
`AddEntitlementCredit`	Add credit to entitlement	“Add $500 credit to ent-123”
`ApplyAddonToEntitlement`	Apply addon to entitlement	“Apply addon to ent-123”
`DivideEntitlementCommit`	Divide entitlement commit	“Divide the commit for ent-123”
`UpdateEntitlementName`	Rename an entitlement	“Rename entitlement ent-123”
`UpdateEntitlementMetaInfo`	Update entitlement metadata	“Update metadata for ent-123”
`UpdateEntitlementPriceModel`	Update pricing model	“Update pricing for ent-123”
`UpdateEntitlementSeat`	Update Azure subscription seats	“Update seat count for Azure entitlement”
`ListEntitlementTerms`	List entitlement terms	“Show terms for ent-123”
`GetEntitlementTerm`	Get entitlement term details	“Get term details for ent-123”
`GetEntitlementPdf`	Download agreement PDF	“Download the agreement PDF for ent-123”

The three renewal tools act on AWS agreements with pre-authorized auto-renewal. See Pre-Authorized Auto-Renewal.

Buyer Management (10)

Tool	Description	Example Prompt
`ListBuyers`	List buyers	“List all buyers”
`QueryBuyers`	Query buyers with filters	“Find buyers with company name Acme”
`GetBuyer`	Get buyer details	“Get buyer details for buyer-123”
`CreateBuyer`	Create a buyer	“Create a new buyer record”
`UpdateBuyer`	Update a buyer	“Update buyer information for buyer-123”
`ListBuyerWallets`	List buyer’s credit wallets	“Show wallets for buyer-123”
`CreateCreditWallet`	Create a credit wallet	“Create a credit wallet for buyer-123”
`UpdateCreditWallet`	Update a credit wallet	“Update credit wallet details”
`CloseCreditWallet`	Close a credit wallet	“Close wallet for buyer-123”
`SetBuyerDefaultWallet`	Set default wallet	“Set default wallet for buyer-123”

Contact Management (9)

Tool	Description	Example Prompt
`ListContacts`	List contacts	“List all contacts”
`QueryContacts`	Query contacts with filters	“Find contacts with @acme.com email”
`GetContact`	Get contact details	“Get contact details for contact-123”
`CreateContact`	Create a contact	“Create a new contact”
`BatchCreateContacts`	Create multiple contacts	“Create contacts in batch”
`UpdateContact`	Update a contact	“Update email for contact-123”
`UpdateContactTags`	Update contact tags	“Add tags to contact-123”
`AddContactToBuyer`	Link contact to buyer	“Link contact-123 to buyer-456”
`AddContactToOffer`	Link contact to offer	“Link contact-123 to offer off-789”

Metering & Usage (14)

Tool	Description	Example Prompt
`ListBillableMetrics`	List billable metrics	“Show all billable metrics”
`GetBillableMetric`	Get billable metric details	“Get metric details for metric-123”
`CreateBillableMetric`	Create a billable metric	“Create a new billable metric”
`UpdateBillableMetric`	Update a billable metric	“Update metric definition”
`ReportUsageRecordGroup`	Report usage	“Report usage for entitlement ent-123”
`BatchReportUsageRecordGroups`	Report usage in batch	“Report usage in batch”
`BatchValidateUsageRecordGroups`	Validate usage records	“Validate usage records before reporting”
`ListUsageRecordGroups`	List usage records	“Show usage records for ent-123”
`AggregateUsageRecordGroups`	Aggregate usage data	“Aggregate usage data”
`RetryUsageRecordGroup`	Retry failed usage report	“Retry failed usage reporting”
`ListUsageRecordReports`	List usage reports	“Show usage reports”
`AggregateUsageRecordReports`	Aggregate usage reports	“Aggregate usage reports”
`GetUsageMeteringConfigInfo`	Get metering config	“Show metering configuration”
`UpdateUsageMeteringConfigInfo`	Update metering config	“Update metering config”

Reports (1)

Tool	Description	Example Prompt
`ListUsageMeteringDailyRecords`	List daily metering records	“Show daily metering records”

Revenue records, reports, and dashboards are not available as tools, because Revenue isn’t part of the public Suger API. Use the Revenue workspace in the Suger console.

Co-Sell (19)

Run the full co-sell referral lifecycle from chat — create, list, update status / stage, sync, and pull dashboard insights. partner selects the destination: AWS, AZURE and GCP share the opportunity with that cloud provider; SUGER shares it with another company you partner with through Suger.

Tool	Description	Example Prompt
`ListCosellReferrals`	List co-sell referrals (inbound + outbound) with filters	“List my AWS referrals in Pending Acceptance status from last week”
`GetCosellReferral`	Get full details of a single co-sell referral by ID	“Show me referral ref-abc123”
`CreateCosellReferral`	Create an outbound co-sell referral to a cloud provider (AWS / AZURE / GCP) or to a partner company (SUGER)	“Create an AWS co-sell referral for Acme Corp, expected close date 2026-09-30”
`RegisterCosellOnBehalf`	File a Suger partner co-sell on a partner’s behalf — for partners who send deals by email and expect you to register them	“Register the deal Acme Corp emailed us on their behalf”
`UpdateCosellReferral`	Update referral fields, status, or stage — and, for a referral a partner shared with you, accept or decline it	“Accept the referral Contoso shared with us”
`BatchCreateCosellReferrals`	Create multiple referrals in one call (recommended ≤ 20)	“Share these 10 opportunities to AWS as referrals”
`BatchPreviewCosellReferrals`	Preview the referrals that would be created from CRM records, before creating them	“Preview referrals for these 5 Salesforce opportunities”
`ValidateReferral`	Dry-run validate a referral against partner schema before creating	“Validate this referral before submitting to AWS”
`PredictReferralQualityScore`	Predict the AWS opportunity quality score for a referral	“Score this AWS opportunity before I submit it”
`SyncSingleReferral`	Sync a single referral with the cloud partner (AWS / Azure / GCP); on a SUGER referral this syncs the linked CRM record instead	“Sync referral ref-abc123 to AWS”
`AzureMicrosoftSolutionLookup`	Search Microsoft’s first-party catalog (Azure, Microsoft 365, Dynamics) and return each match’s solution id	“Find the Microsoft solution id for Azure Kubernetes Service”
`AzureThirdPartySolutionLookup`	Search solutions published by companies other than Microsoft — including your own listings — and return their ids	“Find the Partner Center solution id for our own listing”
`AzureInvitePartnerCollaboration`	Invite another partner to collaborate on an Azure referral (Azure only)	“Invite partner X to collaborate on this Azure referral”
`GetCosellDashboard`	Co-sell insights: pipeline KPIs, outstanding actions, activity logs	“Show my co-sell pipeline for the last 30 days”
`GetPartnerContacts`	List known partner contacts for a buyer company (by email domain)	“Who at AWS have we worked with for acme.com before?”
`SearchPartnerConnections`	Search the org’s connected AWS partners by name	“Find AWS partner connections matching ‘Snowflake’”
`UpdateCosellPartner`	Seller-only: update one partner’s copy of a `SUGER` co-sell — revenue-share terms (before Close Won), deal-value visibility, and collaboration fields	“Hide the deal value from Contoso on referral ref-abc123”
`ProposeCommissionUpdate`	Seller-only: propose new commission terms to a partner after Close Won; the partner must approve	“Propose a 12% commission for Contoso on referral ref-abc123”
`UpdateCommissionLifecycle`	Move a `SUGER` co-sell’s commission to its next state once the deal is Won — approve it, mark payment sent, confirm receipt, or claw it back	“Mark Contoso’s commission on referral ref-abc123 as payment sent”

The three commission tools apply only to SUGER co-sells. See Commission tools for the allowed state changes.

An Azure referral needs at least one entry under details.requirements.solutions, and that entry’s id is a Microsoft catalog identifier that cannot be guessed or composed. Use AzureMicrosoftSolutionLookup for Microsoft’s own products and AzureThirdPartySolutionLookup for everything published by someone else (including your own listings), then pass the id you picked to CreateCosellReferral. Both read the catalog through your organization’s Microsoft Partner Center connection and change nothing, so an organization with no Azure connection cannot use them.

ValidateReferral also returns duplicateOpenReferrals — referrals already in your organization, for the same partner, whose title matches the one being validated and whose status is not yet concluded. It is a warning, not a block: it does not change valid, and two referrals can legitimately share a title (a renewal, or a phased project). Your assistant should tell you which referrals matched and ask before it goes ahead.

Partner Relationship Management (15)

Manage the partner companies you work with and the invitations that bring them onboard. Start with ListPrmPartners to get the partnerId the other partner tools need, and with ListPrmOrgInvitations to get the invitationId the accept / decline / withdraw / resend tools need. To invite a company you don’t have a partnership with yet, use CreatePrmNewPartnerInvitation, which needs no partnerId. ListPrmInvitationLinkableFiles returns the files you can link from an invitation email; pass a file’s id to CreatePrmInvitation or GeneratePrmInvitationEmail.

Tool	Description	Example Prompt
`ListPrmPartners`	List the partner companies this organization has a relationship with	“Who are our partners?”
`GetPrmPartnerDetail`	Get the full record for one partner relationship, including the partner-portal view	“Show me everything about our partnership with Contoso”
`GetPrmPartnerContacts`	List the people at one partner company	“Who should I contact at Contoso?”
`GetPartnerCommissions`	Get one partner’s commission ledger — per closed-won deal, plus totals per currency	“What has Contoso earned from us this year?”
`UpdatePrmPartner`	Update the editable fields of one partner relationship (manager, status, types, profile)	“Assign Dana as the partner manager for Contoso”
`ListPrmOrgInvitations`	List every partner invitation this organization sent or received	“Which partner invitations are still outstanding?”
`ListPrmInvitations`	List the invitations attached to one partner relationship	“Show the invitation history with Contoso”
`CreatePrmInvitation`	Create a partner invitation for an existing partnership, and try to email it to a named recipient	“Invite dana@contoso.com to our Contoso partnership”
`CreatePrmNewPartnerInvitation`	Invite a company that isn’t a partner yet, and try to send the invitation email	“Invite lee@fabrikam.com to partner with us”
`AcceptPrmInAppInvitation`	Accept an invitation another company sent to us, establishing the partnership	“Accept the partnership invitation from Contoso”
`DeclinePrmInAppInvitation`	Decline an invitation another company sent to us; no partnership is created	“Decline the partnership invitation from Contoso”
`CancelPrmInvitation`	Withdraw an invitation we sent, invalidating its accept link	“Cancel the invitation we sent to dana@contoso.com”
`ResendPrmInvitation`	Extend the accept-by date of a pending or expired invitation we sent, and try to re-send the original email	“Resend our invitation to dana@contoso.com”
`GeneratePrmInvitationEmail`	Draft the subject and body for a partnership invitation email — text only, sends nothing	“Draft an invitation email for Contoso”
`ListPrmInvitationLinkableFiles`	List the files you can link from an invitation email — files shared with all partners that can be downloaded	“Which files can we link from a partner invitation?”

An invitation is saved — or, for a resend, given a new accept-by date — even when its email fails, so delivery is reported separately. ResendPrmInvitation returns emailSent; when it is false, no email went out and emailError says why. The two create tools record the outcome on the invitation they return, as info.outbound.emailDelivery.status (SENT or FAILED, with a reason when it failed). Your assistant should check these fields and never report a failed delivery as a plain success. The two create tools also refuse a recipient who already has an invitation in Sent state, so a retry never sends a second email.

Support Tickets (10)

Tool	Description	Example Prompt
`ListSupportTickets`	List support tickets	“Show all open support tickets”
`GetSupportTicket`	Get ticket details	“Get details for ticket-123”
`CreateSupportTicket`	Create a support ticket	“Create a ticket for a billing issue”
`UpdateSupportTicket`	Update a support ticket	“Set ticket-123 priority to high”
`CloseSupportTicket`	Close a ticket	“Close ticket-123”
`ReopenSupportTicket`	Reopen a ticket	“Reopen ticket-123”
`CreateSupportTicketComment`	Add a comment to a ticket	“Add a comment to ticket-123”
`CreateSupportTicketAttachment`	Attach a file to a ticket	—
`CreateOrgSupportAttachment`	Upload a file for a ticket you haven’t created yet, and get back the URL to reference it by in the ticket description	—
`DownloadSupportTicketAttachment`	Download an attachment from a support ticket	“Download the attachment on ticket-123”

Notifications (6)

Tool	Description	Example Prompt
`ListNotificationEvents`	List notification events	“Show recent notification events”
`ListNotificationEventsByEntity`	List notifications for an entity	“Show notifications for offer off-123”
`ListNotificationMessages`	List notification messages	“List notification messages”
`GetNotificationMessage`	Get notification message details	“Get notification message details”
`GetNotificationConfigInfo`	Get organization notification config	“Show my notification settings”
`UpdateNotificationConfigInfo`	Update organization notification config	“Update my notification settings”

Operations (3)

Tool	Description	Example Prompt
`ListOperationsV2`	List operations with filters	“Show recent operations”
`GetOperationV2`	Get operation details	“Get details for operation op-123”
`ListOperationHistoryV2`	Get operation history	“Show operation history”

API Management (2)

Tool	Description	Example Prompt
`ListApiClients`	List API clients	“Show all API clients”
`GetApiClient`	Get API client details	“Get API client details”

Knowledge Search (1)

Tool	Description	Example Prompt
`SearchKnowledge`	Search the marketplace knowledge index (AWS, Azure, GCP docs + Suger docs + support)	“How do I publish a private offer on Azure Marketplace?”

Auditing (1)

Tool	Description	Example Prompt
`QueryAuditingEvents`	Query audit events	“Show audit events from the past 7 days”

Common Parameters

Most tools accept these standard parameters. Your AI assistant discovers the full schema for each tool automatically — you don’t need to specify parameters manually.

Parameter	Type	Description
`orgId`	string	Organization ID (required, path parameter)
`partner`	string	Cloud partner filter: `AWS`, `AZURE`, `GCP`. Co-sell referral tools also accept `SUGER`, meaning a partner company you work with through Suger rather than a cloud provider.
`limit`	number	Page size for list operations
`offset`	number	Pagination offset

Spotted something wrong or out of date on this page? Tell us and we'll correct it.