Supported Tools

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

The Suger MCP Server exposes 126 tools that cover the full Suger API — from listing products and managing entitlements to running the entire co-sell referral lifecycle across AWS, Azure, and GCP. 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 (1)

Tool	Description	Example Prompt
`ListOrganizations`	List organizations	”Show my organizations”

Product Management (13)

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”
`UpdateProductFulfillmentUrl`	Set product fulfillment URL	”Set the fulfillment URL for prod-123”
`PublishProduct`	Publish a product to marketplace	”Publish prod-123 to the marketplace”
`DeleteProduct`	Delete a product	”Delete draft product prod-456”
`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”
`CancelOffer`	Cancel an offer	”Cancel offer off-123”
`DeleteOffer`	Delete an offer	”Delete draft offer off-456”
`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 (21)

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”
`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”
`DeleteEntitlementTerm`	Delete an entitlement term	”Delete a term from ent-123”
`GetEntitlementPdf`	Download agreement PDF	”Download the agreement PDF for ent-123”

Buyer Management (11)

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”
`DeleteBuyerWallet`	Delete a buyer wallet	”Delete wallet for buyer-123”

Contact Management (11)

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”
`RemoveContactFromBuyer`	Unlink contact from buyer	”Unlink contact-123 from buyer-456”
`AddContactToOffer`	Link contact to offer	”Link contact-123 to offer off-789”
`RemoveContactFromOffer`	Unlink contact from offer	”Unlink contact-123 from off-789”

Metering & Usage (15)

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”
`DeleteUsageRecordGroup`	Delete a usage record	”Delete usage record group”
`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”

Revenue & Reports (5)

Tool	Description	Example Prompt
`GetRevenueReport`	Generate a revenue report	”Generate a revenue report for Q4”
`ListRevenueRecords`	List revenue records	”Show revenue records for this month”
`ListRevenueRecordDetails`	List revenue record details	”Show detailed revenue breakdown”
`ListDailyRevenueRecords`	List daily revenue records	”Show daily revenue for the past week”
`ListUsageMeteringDailyRecords`	List daily metering records	”Show daily metering records”

Co-Sell (11)

Run the full co-sell referral lifecycle across AWS, Azure, and GCP from chat — create, list, update status / stage, sync with cloud partners, and pull dashboard insights.

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 partner (AWS / AZURE / GCP)	“Create an AWS co-sell referral for Acme Corp, expected close date 2026-09-30”
`UpdateCosellReferral`	Update referral fields, status, or stage	”Move referral ref-abc123 from Draft to Submitted”
`BatchCreateCosellReferrals`	Create multiple referrals in one call (recommended ≤ 20)	“Share these 10 opportunities to AWS as referrals”
`ValidateReferral`	Dry-run validate a referral against partner schema before creating	”Validate this referral before submitting to AWS”
`SyncSingleReferral`	Sync a single referral inbound or outbound with the cloud partner	”Sync referral ref-abc123 to AWS”
`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‘“

Support Tickets (8)

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	”Attach a file to 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`
`limit`	number	Page size for list operations
`offset`	number	Pagination offset