Suger

Get revenue record detail

GetUnifiedRevenueRecord

Get the current organization's services and quotas Customer-facing read endpoint returning the requesting organization's services snapshot — every catalog service with availability, enablement, the current-period quota usage, remaining/overage minutes, and the full Professional Services quota-period list. Access is gated by org-membership auth: the caller must be a member of {orgId}, and the endpoint returns data only for the caller's own organization.

GetOrganizationLicensesAndServices

Get the provenance event chain for a URR

GetRevenueRecordEvents

Invite a partner to collaborate on an Azure referral (Azure only) Send a collaboration invitation to another Microsoft partner on an existing Azure co-sell referral. This is part of Azure Partner Center's multi-partner co-sell flow and has no AWS / GCP equivalent. Preconditions (handler will reject otherwise): the referral must already exist in Partner Center (has a non-empty `engagementId`), must be Outgoing (originated by your org), must not be Closed, and the invited partner must not be the owner or already invited. Side effect: calls Microsoft Partner Center API. The invited partner will see the referral on their side and can accept / decline. Use this when: user explicitly wants to invite another partner onto an Azure referral. Do NOT use for AWS or GCP referrals — those use different mechanisms.

AzureInvitePartnerCollaboration

List co-sell referrals (inbound + outbound) List co-sell referrals under the organization with pagination, filters, and sort. Covers both inbound (received from a partner) and outbound (shared by us). Use the `q` filter expression to scope by `partner` (AWS / AZURE / GCP), `status`, `stage`, time range, etc. Legal Suger unified status values (DB enum, UPPER_SNAKE_CASE): DRAFT, PENDING_CREATE, CREATE_FAILED, UPDATE_FAILED, IN_REVIEW, PENDING_ACCEPTANCE, ACTION_REQUIRED, ACTIVE, EXPIRED, CLOSED_WON, CLOSED_LOST, CLOSED_ERROR, REJECTED. (DELETED rows are filtered out server-side.) Filter example (qs=lisp, the default): `q=(and (eq partner "AWS") (eq status "IN_REVIEW"))`. Use this when: user wants to browse, search, or filter existing co-sell referrals.

ListCosellReferrals

List known partner contacts for a buyer company Look up partner-side contacts (AWS / AZURE / GCP partner reps) associated with a buyer company, identified by its primary email domain (e.g. "acme.com"). Each contact comes back with a per-partner count of historical referrals, so the caller can identify counterparts by referral volume. Use this when: user is drafting a co-sell referral and needs to pick which partner contact to assign, or wants to see "who at AWS / Azure / GCP have we worked with for this company before".

GetPartnerContacts

List offer sets List offer sets under the given organization with filtering, sorting, and pagination using CRUD query language.

ListOfferSets

List organizations the current user or API client belongs to List all organizations (also known as accounts or tenants) that the authenticated caller has access to. Returns organization details including name, status, cloud marketplace partners, and settings. Use this to discover which organizations you can operate on before calling org-scoped APIs like ListProducts, ListOffers, or ListEntitlements. The caller can be a user (returns orgs the user is a member of) or an API client (returns orgs the API client is authorized for).

ListOrganizations

List revenue channel connections

ListRevenueConnections

List unified revenue records

ListUnifiedRevenueRecords

Search AWS connected partners by name Search the org's connected AWS partners by name. Returns matching partner connections — each item has `id`, `name`, and `awsAccountId` — usable as `partnerId` when creating an outbound AWS co-sell referral. AWS-only. For Azure / GCP, partner selection happens through different mechanisms. Use this when: user is drafting an AWS co-sell referral and needs to pick which connected partner to share with.

SearchPartnerConnections

Search marketplace knowledge Searches the shared knowledge index covering AWS, Azure, and GCP marketplace documentation, Suger docs, and internal support knowledge.

SearchKnowledge

Summarize unified revenue records

SummarizeUnifiedRevenueRecords

Sync Offer Sync the given offer from its partner. Such as AWS marketplace, Azure marketplace or GCP marketplace.

SyncOffer

Sync a single co-sell referral with the partner / CRM Trigger a one-way sync for a specific referral. Controlled by `direction`: - OUTBOUND: CRM -> Suger -> Partner (push local changes to the cloud partner) - INBOUND (default): Partner -> Suger -> CRM (pull partner-side updates into Suger and CRM) This is the primary way to push a Suger-side edit to the partner after calling UpdateCosellReferral, and to refresh Suger with the partner's latest stage/status for an inbound referral. Side effect: for AWS / Azure / GCP, calls the partner API (AWS ACE / Azure Partner Center / GCP) and writes back to Suger DB + linked CRM record (Salesforce / HubSpot / Dynamics 365). `partner=SUGER` referrals (Suger PRM peer-to-peer) are not exposed through this MCP tool. Use this when: user wants to "submit", "push", "refresh", or "sync" one referral.

SyncSingleReferral

Trigger revenue backfill Start a historical revenue-data backfill for one marketplace connection. Use this when a channel was connected late or missed data and its past invoices and disbursements need to be re-synced into unified revenue records.

BackfillRevenueConnection

Update a co-sell referral (incl. status / stage transitions) Update fields of an existing co-sell referral. Used primarily for business field edits (amount, close date, contacts, etc.). Supports AWS / AZURE / GCP. Legal Suger unified status values (DB enum, UPPER_SNAKE_CASE): DRAFT, PENDING_CREATE, CREATE_FAILED, UPDATE_FAILED, IN_REVIEW, PENDING_ACCEPTANCE, ACTION_REQUIRED, ACTIVE, EXPIRED, CLOSED_WON, CLOSED_LOST, CLOSED_ERROR, REJECTED. IMPORTANT: For AWS the unified `status` is recomputed server-side from `info.aceOpportunityV2.lifeCycle`; passing a top-level `status` is not the way to drive state transitions. Instead, edit the partner-specific lifecycle fields and let the server derive `status`. For AWS inbound referrals, sending a body with `info.aceEngagementInvitation` (and no `info.aceOpportunityV2`) triggers the accept/reject engagement-invitation flow. NOTE: changing fields here only updates Suger. To push the change to the partner, call SyncSingleReferral with `direction=OUTBOUND` afterwards. `partner=SUGER` (Suger PRM) is not exposed through this MCP tool. Use this when: user wants to edit a referral's fields or progress an AWS inbound referral via invitation accept/reject.

UpdateCosellReferral

Update offer pricing (unified format) Add new usage dimensions or update existing dimension rates (at negotiated rates) on a released AWS private offer. AWS validates whether modifying an existing dimension is permitted. A new dimension must already exist on the product's public offer.

UpdateOfferPrice

Update product pricing (unified format) Update AWS or Azure product pricing with one partner-agnostic request (plans[] with commits + dimensions). Azure auto-goes-live.

UpdateProductPrice

add contact to buyer add contact to buyer by the given organization, buyer id and contact id.

AddContactToBuyer

add contact to offer add contact to offer by the given organization, offer id and contact id.

AddContactToOffer

add entitlement credit Add the credit amount to the given Entitlement. The credit amount is accumulated & saved in the current Entitlement Term of the given Entitlement.

AddEntitlementCredit

aggregate revenue records Return per-currency totals (invoice/collectable/disburse/tax + count) and the daily chart series over the filtered set, in a single request. Lets a console view render its chart and summary without loading individual rows. Invoice amounts are net of refund_invoice_amount (a fully refunded record contributes 0); collectable, disburse, and tax amounts are gross sums of their respective columns.

AggregateRevenueRecords

aggregate usageRecordGroups Aggregate usageRecordGroups by date and dimension key.

AggregateUsageRecordGroups

aggregate usageRecordReports Aggregate usageRecordReports by date and dimension key.

AggregateUsageRecordReports

apply addon to entitlement Apply one billing addon to the given Entitlement. The entitlement status must be ACTIVE.

ApplyAddonToEntitlement

approve entitlement Approve the given Entitlement. Only applicable to the Azure or GCP Entitlements with the status of "PENDING_START". Return 200 if the entitlement is already active.

ApproveEntitlement

batch create contacts Create multiple contacts under the given organization. If an email address already exists, return the existing contact.

BatchCreateContacts

batch report usageRecordGroups Batch report new usage record groups.

BatchReportUsageRecordGroups

batch validate usageRecordGroups Provide a batch of usage record groups and validate each individual usage record group one by one.

BatchValidateUsageRecordGroups

cancel entitlement Cancel the active subscription in Azure Marketplace.

CancelEntitlement

cancel offer Only the offer with status = "PENDING_ACCEPTANCE", "PENDING_CANCEL", "ACTIVE" or "USED" is allowed to cancel.

CancelOffer

close credit wallet Close the given credit wallet, if it's a payment method, sync to payment provider too. Once closed, it can't be used for payment.

CloseCreditWallet

close support ticket close support ticket

CloseSupportTicket

create billable metric Create a new billable metric for the given organization.

CreateBillableMetric

create buyer create a new buyer for Stripe or Adyen under the given organization.

CreateBuyer

create contact Create a contact under the given organization. If the email address already exists, return the existing contact.

CreateContact

create credit wallet create a new credit wallet for the buyer.

CreateCreditWallet

create entitlement Create a new entitlement for the given buyer & offer. Only applicable to non cloud billing partners.

CreateEntitlement

create offer Create a private offer under the given organization.

CreateOffer