Onboarding tools

Who the platform thinks you are. Your account, site and permissions.

Read only.

Resourceresources/read aikonic://public/get_me

Arguments

A resource takes no arguments: the agent reads it by its address.

Your account's go-live checklist. Each step, its state and what is still needed.

Read only.

Resourceresources/read aikonic://public/get_activation

Arguments

A resource takes no arguments: the agent reads it by its address.

The integration checks observed from your sandbox traffic.

Read only.

Resourceresources/read aikonic://public/get_certification

Arguments

A resource takes no arguments: the agent reads it by its address.

Run the integration checks your sandbox traffic has not covered yet.

Makes a change that moves no money. It runs only where your account lets agents make changes; otherwise the agent is told the change needs approval.

Tool signaturerun_missing_certification_checks(
  idempotencyKey*: string (uuid)
)
// * required   ? optional

Arguments

• 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 ….

The public profile of one agent by handle.

Read only.

Resourceresources/read aikonic://public/resolve_agent{?handle}

Arguments

• handlerequired
  string The agent handle, name@domain: a hosted handle is name@<tenantSlug>.agents.aikonic.travel, an own-domain handle is name@your-domain.

Search the travel agent directory.

Read only.

Tool signaturesearch_agent_directory(
  canHold?: boolean,
  cursor?: string,
  limit?: integer,
  protocol?: enum,
  q?: string,
  tier?: enum
)
// * required   ? optional

Arguments

• canHoldoptional
  boolean True lists only agents allowed to place holds (commit-lite tools); false lists only read-only agents; omitted lists both.
• cursoroptional
  string Opaque cursor from the previous page nextCursor; omit for the first page.
• limitoptional
  integer Rows per page, 1 to 50; the default is 20.
• protocoloptional
  enum Only agents that speak this protocol: mcp, a2a or http.mcpa2ahttp
• qoptional
  string Free text matched against the agent name, handle and capabilities.
• tieroptional
  enum The lowest tier to list, T1 to T3; the default is T1.T1T2T3

Where your account is on the way to going live, and the next step to take.

Coming soon. Documented here, not available to agents yet.

Tool signatureonboard()

Arguments

Takes no arguments.

Your account's API keys. Never a secret.

Coming soon. Documented here, not available to agents yet.

Tool signaturelist_api_keys()

Arguments

Takes no arguments.

Create a scoped API key. The secret is shown once, in the answer.

Coming soon. Documented here, not available to agents yet.

Tool signaturemint_api_key(
  body*: MintApiKeyRequest
)
// * required   ? optional

Arguments

• bodyrequired
  MintApiKeyRequest A new API key, what it may do and the limits it runs under.

  MintApiKeyRequest: 15 fields

  • actorKindoptional
    enum The channel the key acts as; default ai.aisystem
  • cancelsPerDayoptional
    integer \| null The most cancellations the key may request per UTC day; null means no cap.
  • environmentoptional
    enum Optional; defaults to this deployment's environment, and any other value is a 400.sandboxlive
  • expiresAtoptional
    string \| null (date-time) In the future (else 400 VALIDATION details.field expiresAt).
  • holdsPerHouroptional
    integer \| null The most holds the key may place per hour; null means no cap.
  • ipAllowlistoptional
    array of string The only addresses or ranges the key may call from; empty means any.
  • lookToBookoptional
    integer \| null The most searches the key may make per booking, counted per UTC day; null means no cap.
  • nameoptional
    string A name for the key, shown in the key list.
  • onBehalfOfoptional
    string (email) The Member the key acts for (its principal); default the caller.
  • productsoptional
    array \| null Product tab keys (hotels, flights), each reached by one of the key's search:<tabKey> scopes (else 400 VALIDATION details.field products).
  • reqPerSecoptional
    integer \| null The most requests per second the key may make; null means no cap of its own.
  • scopesrequired
    array of string At least one and at most 32 (ApiKeyService.MAX_SCOPES; more is 400 VALIDATION details.field scopes); known permission strings, a subset of the minting user's (deny-by-default).
  • spendPerDayoptional
    oneOf Daily spend cap, in the tenant's cap currency (else 400 VALIDATION CURRENCY_MISMATCH).
  • suppliersoptional
    array of string Optional supplier allowlist: the supplier registry codes (GET /v1/capabilities products[].suppliers[].code) this key may reach.
  • writesoptional
    oneOf The write ladder (KeyWrites); under the narrowing rule no higher than the minting key's, and the minting key's when left out or null.

Revoke an API key immediately.

Coming soon. Documented here, not available to agents yet.

Tool signaturerevoke_api_key(
  keyPrefix*: string
)
// * required   ? optional

Arguments

• keyPrefixrequired
  string The key to revoke, by the prefix the key list shows.