KosmoKrator

finance

Adyen MCP Integration for Vercel AI SDK

Connect Adyen to Vercel AI SDK through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.

8 functions 5 read 3 write API key auth
Submit Adyen feedback View package source

Connect Adyen to Vercel AI SDK

Use KosmoKrator as a local integration gateway for Vercel AI SDK agents and scripts.

Create an MCP client that starts or connects to the KosmoKrator gateway for the selected integration. The gateway is local, scoped to this integration, and starts with --write=deny so Vercel AI SDK can inspect read-capable tools without receiving write access by default.

Adyen MCP Config for Vercel AI SDK

Prefer CLI JSON calls when a workflow only needs one deterministic integration operation.

{
  "mcpServers": {
    "kosmokrator-adyen": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=adyen",
        "--write=deny"
      ]
    }
  }
}

Run the Gateway Manually

kosmokrator mcp:serve --integration=adyen --write=deny

Why Use KosmoKrator Here

Scoped tools

Expose only Adyen instead of a broad multi-service tool list.

Local credentials

Reuse credentials already configured for the KosmoKrator CLI and Lua runtime.

Write policy

Start read-only, then opt into ask or allow for trusted workspaces.

Adyen Tools Visible to Vercel AI SDK

Vercel AI SDK sees stable MCP tool names generated from the Adyen integration catalog.

MCP toolSource functionTypeDescription
integration__adyen__adyen_capture_payment adyen.adyen_capture_payment Write Capture a previously authorized Adyen payment. Requires the PSP reference of the original payment and the amount to capture (value in minor units + currency). The merchant account is automatically injected.
integration__adyen__adyen_get_current_merchant adyen.adyen_get_current_merchant Read Get current merchant account information from Adyen. Verifies API connectivity and returns available payment methods for the merchant account.
integration__adyen__adyen_get_current_user adyen.adyen_get_current_user Read Verify Adyen API connectivity and retrieve current merchant account information. Useful as a health check to confirm the integration is properly configured.
integration__adyen__adyen_get_transaction adyen.adyen_get_transaction Read Get details of a specific Adyen transaction by its PSP reference. Returns the full transaction object including amount, status, and payment details.
integration__adyen__adyen_list_stores adyen.adyen_list_stores Read List stores for the configured Adyen merchant account. Returns store details including store codes, names, and addresses. The merchant account is automatically injected.
integration__adyen__adyen_list_transactions adyen.adyen_list_transactions Read List transactions from the Adyen transaction feed. Returns a paginated list of transactions for the merchant account. Use page and size parameters to control pagination.
integration__adyen__adyen_make_payment adyen.adyen_make_payment Write Initiate a payment through Adyen. Requires amount (value in minor units + currency) and payment method. The merchant account is automatically injected from the integration configuration. Returns the payment result including PSP reference.
integration__adyen__adyen_refund_payment adyen.adyen_refund_payment Write Refund an Adyen payment (full or partial). Requires the PSP reference of the original payment and the amount to refund (value in minor units + currency). The merchant account is automatically injected.

Related Adyen Pages

Adyen CLIUse direct JSON commands instead of MCP discovery. Adyen MCPFull gateway reference and MCP tool names. KosmoKrator for Vercel AI SDKClient-level gateway setup.