KosmoKrator

finance

Adyen MCP Integration for Claude Agent SDK

Connect Adyen to Claude Agent 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 Claude Agent SDK

Give Claude Agent SDK workflows access to KosmoKrator integrations through a local MCP server.

Add a KosmoKrator stdio MCP server to the Claude Agent SDK options. The gateway is local, scoped to this integration, and starts with --write=deny so Claude Agent SDK can inspect read-capable tools without receiving write access by default.

Adyen MCP Config for Claude Agent SDK

Use a narrow integration list so the agent does not load unrelated tools.

{
  "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 Claude Agent SDK

Claude Agent 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 Claude Agent SDKClient-level gateway setup.