Skip to main content
Watch: I Built an AI App Without Leaving Databricks

Payments and finance - official Adyen server

Adyen MCP server

Local MCP server that lets an LLM client call Adyen Checkout, Management, Configuration and Legal Entity Management APIs through function calling, for tasks such as creating payment sessions and links, refunds and cancellations, and managing terminals, webhooks and users. It runs locally from @adyen/mcp (npm) with API key auth.

Last verified 15 tools5 sources

Install

VS Code

JSON
{
  "servers": {
    "adyen-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@adyen/mcp", "--env=TEST"],
      "env": {
        "ADYEN_API_KEY": "${ADYEN_API_KEY}"
      }
    }
  }
}

Generic

Terminal
npx -y @adyen/mcp --adyenApiKey=ADYEN_API_KEY --env=TEST

Tools

create_payment_session
Creates a /sessions payment request
get_payment_session
Gets the result of a payment session
get_payment_methods
Gets the available payment methods
create_payment_links
Creates a payment link
get_payment_link
Gets the status of a payment link
update_payment_link
Updates a payment link (force expiry of the link)
cancel_payment
Cancels an authorized payment
refund_payment
Refunds a captured payment
list_merchant_accounts
Gets a list of merchant accounts for your company account
list_terminals
Gets a list of terminals
reassign_terminal
Reassigns a terminal
create_terminal_action
Creates a terminal action
get_terminal_settings
Gets terminal settings
list_all_company_webhooks
List all webhooks for a company account
test_merchant_webhook
Test a webhook for a merchant account

As documented on October 17, 2026. A running server reports its current list through tools/list.

Notes and caveats

  • The repo README is titled 'Adyen MCP Server - Alpha'; mapped to preview.
  • Runs locally only (no hosted endpoint).
  • Requires an Adyen API key (ADYEN_API_KEY env var or --adyenApiKey) and --env=TEST or --env=LIVE; LIVE also needs --livePrefix.
  • The API credential needs specific webservice roles per tool; Adyen recommends a dedicated webservice user. --tools restricts the exposed tool set.
  • Tool names come from the vendor's published @adyen/mcp 0.6.0 package (the README lists endpoints, not names); the package also includes legal entity, onboarding link and account holder tools.

More MCP servers for payments and finance

Related reading

FAQ

What does the Adyen MCP server do?

Local MCP server that lets an LLM client call Adyen Checkout, Management, Configuration and Legal Entity Management APIs through function calling, for tasks such as creating payment sessions and links, refunds and cancellations, and managing terminals, webhooks and users. The vendor documents 15 tools, including create_payment_session, get_payment_session, get_payment_methods and create_payment_links.

How do I add the Adyen MCP server to VS Code?

Adyen documents a VS Code config; copy it from the VS Code section of this page. Snippets for Generic are there too.

Does the Adyen MCP server need authentication?

Yes, API key. Transport: stdio. Status: Preview, last checked October 17, 2026.

Sources

Last verified against 5 Adyen pages, then re-checked independently.

Newsletter

New MCP servers, the week they ship

One email per week. New official MCP servers, the coding tools that support them and how developers wire them up.