Supplier tools
For suppliers selling through the platform: the bookings routed to you, your performance, statements, contract and integration health. An agent you connect here acts as you and can only read.
- Endpoint
/mcp/supplier- Sign-in
- You sign in as yourself (OAuth 2.1). You approve the agent in your browser and choose what it may read.
- Availability
- Sandbox only for now.
Your account 6
supplier_me
Read only#Who you are signed in as. Supplier, role and permissions.
Read only.
Resourceresources/read aikonic://supplier/supplier_me
Arguments
A resource takes no arguments: the agent reads it by its address.
list_supplier_users
Read only#Your users and their roles.
Read only.
Resourceresources/read aikonic://supplier/list_supplier_users
Arguments
A resource takes no arguments: the agent reads it by its address.
supplier_contract
Read only#Your contract.
Read only.
Resourceresources/read aikonic://supplier/supplier_contract
Arguments
A resource takes no arguments: the agent reads it by its address.
supplier_compliance_documents
Read only#Your compliance documents.
Read only.
Resourceresources/read aikonic://supplier/supplier_compliance_documents
Arguments
A resource takes no arguments: the agent reads it by its address.
supplier_notification_prefs
Read only#Your notification preferences.
Read only.
Resourceresources/read aikonic://supplier/supplier_notification_prefs
Arguments
A resource takes no arguments: the agent reads it by its address.
supplier_sandbox_info
Read only#Your sandbox details.
Read only.
Resourceresources/read aikonic://supplier/supplier_sandbox_info
Arguments
A resource takes no arguments: the agent reads it by its address.
Integration and certification 4
supplier_cert_status
Read only#Your certification status.
Read only.
Resourceresources/read aikonic://supplier/supplier_cert_status
Arguments
A resource takes no arguments: the agent reads it by its address.
supplier_integration_health
Read only#The health of your integration.
Read only.
Resourceresources/read aikonic://supplier/supplier_integration_health
Arguments
A resource takes no arguments: the agent reads it by its address.
supplier_feeds
Read only#The health of your content feeds.
Read only.
Resourceresources/read aikonic://supplier/supplier_feeds
Arguments
A resource takes no arguments: the agent reads it by its address.
supplier_breaker_events
Read only#Times the platform paused traffic to your integration, and why.
Read only.
Resourceresources/read aikonic://supplier/supplier_breaker_events
Arguments
A resource takes no arguments: the agent reads it by its address.
Bookings 3
list_supplier_bookings
Read only#The bookings routed to you, on-request first.
Read only.
Tool signaturelist_supplier_bookings( domain?: string, from?: string (date), page?: integer, pageSize?: integer, state?: string, to?: string (date) ) // * required ? optional
Arguments
domainoptionalstring Only bookings of this product, by its product code (for example HTL).fromoptionalstring (date) Start of the date range (inclusive).pageoptionalinteger Page number, 1-based.pageSizeoptionalinteger Rows per page, 1..200 (console lists).stateoptionalstring Only bookings in this state.tooptionalstring (date) End of the date range (inclusive).
get_supplier_booking
Read only#One booking routed to you.
Read only.
Resourceresources/read aikonic://supplier/get_supplier_booking/{bookingRef}
Arguments
bookingRefrequiredstring The booking to read, as the supplier's booking list names it.
supplier_disputes
Read only#Your disputes.
Read only.
Resourceresources/read aikonic://supplier/supplier_disputes
Arguments
A resource takes no arguments: the agent reads it by its address.
Performance 8
supplier_analytics_volume
Read only#Your booking volume.
Read only.
Tool signaturesupplier_analytics_volume( from?: string, to?: string ) // * required ? optional
Arguments
fromoptionalstring Start of the window: an ISO date (UTC day) or instant.tooptionalstring End of the window (exclusive): an ISO date (the whole UTC day) or instant.
supplier_analytics_conversion
Read only#Your conversion funnel.
Read only.
Tool signaturesupplier_analytics_conversion( from?: string, to?: string ) // * required ? optional
Arguments
fromoptionalstring Start of the window: an ISO date (UTC day) or instant.tooptionalstring End of the window (exclusive): an ISO date (the whole UTC day) or instant.
supplier_analytics_l2b
Read only#Your look-to-book ratio.
Read only.
Tool signaturesupplier_analytics_l2b( from?: string, to?: string ) // * required ? optional
Arguments
fromoptionalstring Start of the window: an ISO date (UTC day) or instant.tooptionalstring End of the window (exclusive): an ISO date (the whole UTC day) or instant.
supplier_analytics_cancellations
Read only#Your cancellations and declines.
Read only.
Tool signaturesupplier_analytics_cancellations( from?: string, to?: string ) // * required ? optional
Arguments
fromoptionalstring Start of the window: an ISO date (UTC day) or instant.tooptionalstring End of the window (exclusive): an ISO date (the whole UTC day) or instant.
supplier_analytics_response_times
Read only#Your response times.
Read only.
Tool signaturesupplier_analytics_response_times( from?: string, to?: string ) // * required ? optional
Arguments
fromoptionalstring Start of the window: an ISO date (UTC day) or instant.tooptionalstring End of the window (exclusive): an ISO date (the whole UTC day) or instant.
supplier_analytics_errors
Read only#Failed calls to your integration, by kind.
Read only.
Tool signaturesupplier_analytics_errors( from?: string, to?: string ) // * required ? optional
Arguments
fromoptionalstring Start of the window: an ISO date (UTC day) or instant.tooptionalstring End of the window (exclusive): an ISO date (the whole UTC day) or instant.
supplier_analytics_api_calls
Read only#Your API traffic from the platform.
Read only.
Tool signaturesupplier_analytics_api_calls( from?: string, limit?: integer, operation?: string, outcome?: SupplierCallOutcome, to?: string ) // * required ? optional
Arguments
fromoptionalstring Start of the window: an ISO date (UTC day) or instant.limitoptionalinteger At most this many rows, newest first (1..500, default 100).operationoptionalstring Narrow to one supplier operation, as journalled.outcomeoptionalSupplierCallOutcome Narrow to one call outcome.tooptionalstring End of the window (exclusive): an ISO date (the whole UTC day) or instant.
supplier_sla_scorecard
Read only#Your service-level scorecard.
Read only.
Resourceresources/read aikonic://supplier/supplier_sla_scorecard
Arguments
A resource takes no arguments: the agent reads it by its address.
Settlements 2
supplier_settlements
Read only#Your settlement statements.
Read only.
Resourceresources/read aikonic://supplier/supplier_settlements
Arguments
A resource takes no arguments: the agent reads it by its address.
supplier_reconcile_statement
Read only#Reconcile a statement against your own lines.
Read only.
Tool signaturesupplier_reconcile_statement( body*: SupplierReconcileRequest, idempotencyKey*: string (uuid), statementId*: string ) // * required ? optional
Arguments
bodyrequiredSupplierReconcileRequest The supplier's own lines to match against a statement.SupplierReconcileRequest: 1 field
linesrequiredarray of object Your own statement lines to match.4 fields
amountrequiredinteger The line's amount, in minor units of its currency.currencyrequiredstring The line's currency, as an ISO 4217 code.lineIdoptionalstring Your own id for the line, matched with the booking reference when sent.supplierBookingRefrequiredstring The booking the line is for, by your booking reference.
idempotencyKeyrequiredstring (uuid) Mandatory on mutations: **48h TTL**; replay with same body-hash returns the original response with Idempotency-Replayed true; same key + different body is 409 ….statementIdrequiredstring The settlement statement to reconcile against.
Types 2
The shapes the arguments above refer to.
SupplierCallOutcome
#How a supplier call attempt ended (adapter SDK SupplierCallEntry.Outcome: SUCCEEDED, REFUSED_UNBOUND, REFUSED_EGRESS, REFUSED_UNSENT, FAILED_PROTOCOL, FAILED_TRANSPORT, TIMED_OUT, ABANDONED_IN_FLIGHT).
SupplierReconcileRequest
#The supplier's own lines to match against a statement.
linesrequiredarray of object Your own statement lines to match.4 fields
amountrequiredinteger The line's amount, in minor units of its currency.currencyrequiredstring The line's currency, as an ISO 4217 code.lineIdoptionalstring Your own id for the line, matched with the booking reference when sent.supplierBookingRefrequiredstring The booking the line is for, by your booking reference.