{
  "jsonrpc": "2.0", "id": 1, "method": "tools/call",
  "params": {
    "name": "list_corporates",
    "arguments": {},
    "_meta": { "sokin.com/full-response": true }
  }
}

{
  "data": {
    "items": [
      {
        "corporateReference": "CORP-1",
        "corporateName": "Acme Ltd",
        "assignmentType": "direct"
      }
    ]
  }
}

{
  "data": {
    "items": [
      {
        "corporateReference": "CORP-1",
        "corporateName": "Acme Ltd",
        "assignmentType": "direct",
        "activeFrom": "2026-01-01T00:00:00Z",
        "features": { "paymentAcceptance": true }
      }
    ]
  }
}

{
  "data": [ "..." ],
  "pagination": {
    "nextToken": "eyJrIjoi...",
    "previousToken": null,
    "totalItems": 128,
    "hasMore": true
  }
}

2 corporates: CORP-8842 — Northwind Trading Ltd (direct assignment); CORP-9110 — Northwind Logistics BV (inherited access).

2 accounts for CORP-8842: CCA-1001 (GBP) — balance 48200.00, of which 47150.00 available; CCA-1002 (USD) — balance 12000.00, available balance not computable.

Account CCA-1001 (GBP): balance 48200.00, of which 47150.00 available. Local funding: active — ready to receive payments — pay into Northwind Trading Ltd, account 12345678, SortCode 04-00-75, at Modulr FS Limited (London branch), GB. International funding: not yet set up.

Instruction INS-5513 (FXPayment) for corporate CORP-8842, account CCA-1002: 800.00 USD -> 742.10 EUR, status Pending Settlement. Beneficiary: BEN-3301. Sender reference (shown to the recipient): INV-4471. Purpose: SUPPLIER_PAYMENT. Fees: 4.20 FX, 1.50 transaction, 0.00 reseller. Created 2026-08-16T11:03:02Z, updated 2026-08-16T11:04:18Z.

Instruction request IR-Payment-1 is still being processed -- no outcome yet. Check again shortly.

Instruction request IR-Payment-1 was accepted: instruction INS-42 was created. Use get_instruction for its full detail.

Instruction request IR-Payment-1 was rejected: Insufficient balance (category: amount). No instruction was created.

Validation passed: this payment would clear the creation checks. Total debit 1256.70 (5.20 Sokin fee, 1.50 reseller fee); beneficiary would receive 1250.00. Nothing was created and no money moved.

Validation failed: insufficient available balance on the source account (category: amount). The engine still computed amounts: total debit 1256.70 (5.20 Sokin fee, 1.50 reseller fee). Nothing was created and no money moved.

Payment prepared and validated -- awaiting the user's confirmation in the review widget. Nothing has been submitted; do not report this payment as made, and do not call submit_payment_instruction yourself.

Payment prepared and validated -- nothing has been submitted yet. idempotency key: 3fae1c9e-... . Read the draft and fees back to the user and get their explicit approval; only after they approve, call submit_payment_instruction yourself with this idempotency_key and the exact same arguments. Never submit without that approval, and never tell the user the payment was made until submit_payment_instruction succeeds -- it may still need approval in the Sokin portal afterward.

The payment could not be validated: insufficient available balance on the source account. Fix the inputs (validate_payment_instruction is the pre-flight) and prepare again. Nothing has been submitted.

Payment submitted: instruction request IR-Payment-77 for 125.50 from CCA-1 to BEN-1. This is an instruction-request reference, not a completed payment -- check the outcome via get_instruction_request.

This draft was already submitted -- no new payment was created. Instruction request IR-Payment-77 was accepted: instruction INS-9 was created. Use get_instruction for its full detail.

Ready to quote GBP -> USD, 1000.00 on the sell side. No quote has been created yet -- the card's Get Quote button mints one.

FX quote QT-88213: 1000.00 GBP -> 1187.40 USD at rate 1.18740 (GBPUSD). Fees: 2.50 FX. Valid until 2026-08-27T14:32:10+00:00. Cut-off time: 2026-08-27T16:00:00+00:00. This rate is indicative and short-lived (see the expiry above) -- go to https://portal.uat.sokin.com/v2/transfer/currency-exchange to actually execute this trade; it cannot be settled through this assistant.

Error: this session has not declared MCP UI support, so creating a real FX quote is refused here -- there is no card to display it in. Direct the user to the Sokin dashboard to get a live rate and execute a trade instead.

Quote QT-88213 created: 1000.00 GBP -> 1187.40 USD at rate 1.18740. Expires at 2026-08-27T14:34:00+00:00 -- settle it before then, or ask for a fresh quote once it expires.

Error: quote QT-88213 was created but could not be tracked -- it cannot be settled through this assistant. Do not report a usable quote to the user; ask for a fresh one via get_fx_quote.

Error: this session has not declared MCP UI support, so real-money FX settlement is refused here. Direct the user to the Sokin dashboard to execute this trade instead.

FX conversion submitted: instruction request IR-FX-9911 for account CCA-1002. This is a submission receipt, not confirmation the conversion completed -- check get_instruction_request for its actual outcome.

FX payment prepared and validated -- awaiting the user's confirmation in the review widget. Nothing has been submitted; do not report this payment as made, and do not call submit_fx_payment_instruction yourself.

FX payment prepared and validated -- nothing has been submitted yet. Total debit 100.00 (0.50 Sokin fee, 0.00 reseller fee); beneficiary would receive 125.00 (GBP debited, beneficiary receives USD). idempotency key: 9c21ab4f-... . quote_id: FXQ-1a2b3c... . Read these figures back to the user and get their explicit approval. Only after they approve, call submit_fx_payment_instruction with this idempotency_key, this quote_id, and the same corporate_currency_account, beneficiary_reference, reseller_fee, sender_reference, and payment_purpose you used here -- it does not take buy_currency, sell_currency, amount, fixed_side, or corporate_reference; those only mint the quote. Never submit without that approval, and never tell the user the payment was made until submit_fx_payment_instruction succeeds -- it may still need approval in the Sokin portal afterward.

The FX payment could not be validated: <reason>. Nothing has been submitted.

Error: the quote minted for this request is no longer valid (<reason>). Call create_fx_payment_instruction again to mint a fresh one. Nothing has been submitted.

FX payment submitted: instruction request IR-FXPayment-77 from CCA-1 to BEN-1. This is an instruction-request reference, not a completed payment -- depending on the corporate's approval rules it may now be awaiting a human approval in the Sokin portal before it is processed. Check the outcome via get_instruction_request.

{
  "mcpServerUrl": "https://mcp.uat.sokin.com",
  "documentation": [
    {
      "topic": "b2b_api",
      "title": "Sokin B2B API reference",
      "url": "https://docs.sokin.com/llms.txt",
      "alternateUrl": "https://docs.sokin.com",
      "summary": "The Sokin B2B REST API this MCP server calls: every endpoint, authentication, API versions, and request/response schemas"
    },
    {
      "topic": "mcp_server",
      "title": "Sokin MCP server reference",
      "url": null,
      "alternateUrl": null,
      "summary": "No published reference yet -- every tool on this server is self-describing, so read the tool list and tool descriptions you already have from this connection"
    }
  ]
}

Cheetah Dash is ready -- use Space or tap to jump, again mid-air to double jump.