Skip to content
ApiqDevelopers
API v1.64.0Open console

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.
23tools & resources

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

  • domainoptional
    string Only bookings of this product, by its product code (for example HTL).
  • fromoptional
    string (date) Start of the date range (inclusive).
  • pageoptional
    integer Page number, 1-based.
  • pageSizeoptional
    integer Rows per page, 1..200 (console lists).
  • stateoptional
    string Only bookings in this state.
  • tooptional
    string (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

  • bookingRefrequired
    string 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

  • fromoptional
    string Start of the window: an ISO date (UTC day) or instant.
  • tooptional
    string 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

  • fromoptional
    string Start of the window: an ISO date (UTC day) or instant.
  • tooptional
    string 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

  • fromoptional
    string Start of the window: an ISO date (UTC day) or instant.
  • tooptional
    string 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

  • fromoptional
    string Start of the window: an ISO date (UTC day) or instant.
  • tooptional
    string 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

  • fromoptional
    string Start of the window: an ISO date (UTC day) or instant.
  • tooptional
    string 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

  • fromoptional
    string Start of the window: an ISO date (UTC day) or instant.
  • tooptional
    string 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

  • fromoptional
    string Start of the window: an ISO date (UTC day) or instant.
  • limitoptional
    integer At most this many rows, newest first (1..500, default 100).
  • operationoptional
    string Narrow to one supplier operation, as journalled.
  • outcomeoptional
    SupplierCallOutcome Narrow to one call outcome.
  • tooptional
    string 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

  • bodyrequired
    SupplierReconcileRequest The supplier's own lines to match against a statement.
    SupplierReconcileRequest: 1 field
    • linesrequired
      array of object Your own statement lines to match.
      4 fields
      • amountrequired
        integer The line's amount, in minor units of its currency.
      • currencyrequired
        string The line's currency, as an ISO 4217 code.
      • lineIdoptional
        string Your own id for the line, matched with the booking reference when sent.
      • supplierBookingRefrequired
        string The booking the line is for, by your booking reference.
  • idempotencyKeyrequired
    string (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 ….
  • statementIdrequired
    string 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.

  • linesrequired
    array of object Your own statement lines to match.
    4 fields
    • amountrequired
      integer The line's amount, in minor units of its currency.
    • currencyrequired
      string The line's currency, as an ISO 4217 code.
    • lineIdoptional
      string Your own id for the line, matched with the booking reference when sent.
    • supplierBookingRefrequired
      string The booking the line is for, by your booking reference.