KosmoKrator

finance

Adyen MCP Integration for Codex

Connect Adyen to Codex 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 Codex

Use KosmoKrator as a local MCP proxy for Codex so coding sessions can reach selected integrations with explicit write policy.

Register kosmo mcp:serve as a local stdio server and choose the integration allowlist. The gateway is local, scoped to this integration, and starts with --write=deny so Codex can inspect read-capable tools without receiving write access by default.

Adyen MCP Config for Codex

Keep write access denied or ask-based unless the workspace is trusted.

{
  "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 Codex

Codex 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 CodexClient-level gateway setup.