Supported Tools
Full reference for all 122 tools available through the Suger MCP Server.
The Suger MCP Server exposes 122 tools that cover the full Suger API — from listing products to issuing invoices. 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.
info
Your AI assistant can only perform actions that your Suger account has permission to do.
Organization (1)
| Tool | Description | Example Prompt |
|---|---|---|
ListOrganizations | List organizations | "Show my organizations" |
Product Management (12)
| 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" |
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 (19)
| 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" |
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" |
Billing & Invoicing (10)
| Tool | Description | Example Prompt |
|---|---|---|
ListInvoices | List invoices | "List all invoices" |
GetInvoice | Get invoice details | "Get invoice inv-123" |
UpdateInvoiceInfo | Update invoice info | "Update invoice details" |
IssueInvoice | Issue an invoice | "Issue invoice inv-123" |
PayInvoice | Mark invoice as paid | "Mark invoice inv-123 as paid" |
VoidInvoice | Void an invoice | "Void invoice inv-123" |
PreviewInvoiceEmail | Preview invoice email | "Preview the email for inv-123" |
ListPaymentTransactions | List payment transactions | "Show payment history" |
ListRefundOfPaymentTransaction | List refunds for a transaction | "Show refunds for transaction tx-123" |
CreateRefund | Create a refund | "Create a refund for tx-123" |
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 (1)
| Tool | Description | Example Prompt |
|---|---|---|
| Search partner connections | Search AWS partner connections | "Search for AWS partner connections" |
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 (4)
| 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" |
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" |
Search (1)
| Tool | Description | Example Prompt |
|---|---|---|
ListSearchableObjects | Global search across all entities | "Search for 'Acme' across everything" |
Auditing (1)
| Tool | Description | Example Prompt |
|---|---|---|
QueryAuditingEvents | Query audit events | "Show audit events from the past 7 days" |
AI Usage (1)
| Tool | Description | Example Prompt |
|---|---|---|
GetAIUsage | Get AI usage statistics | "Show my AI usage statistics" |
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 |