---
title: "Adyen Model Context Protocol (MCP) server"
description: "Integrate with our APIs using LLMs with our MCP server."
url: "https://docs.adyen.com/development-resources/mcp-server"
source_url: "https://docs.adyen.com/development-resources/mcp-server.md"
canonical: "https://docs.adyen.com/development-resources/mcp-server"
last_modified: "2025-06-11T14:59:00+02:00"
language: "en"
---

# Adyen Model Context Protocol (MCP) server

Integrate with our APIs using LLMs with our MCP server.

[View source](/development-resources/mcp-server.md)

##### Learn more

Read more about the launch of our MCP server in our [tech blog](https://www.adyen.com/knowledge-hub/mcp-release).

[Our Model Context Protocol (MCP) server](https://github.com/Adyen/adyen-mcp) lets you use natural language with your chosen Large Language Model (LLM) client. This allows developers to use natural language to connect with Adyen's platform more easily and build new payment solutions faster.

## How it works

Use our MCP server to integrate with our APIs through function calling. This lets you integrate and interact with Adyen APIs seamlessly. The MCP contains a set of tools that lets you interact with the Adyen APIs for common use cases, using your client of choice.

Currently, interactions with the following APIs are supported, we are working on adding more APIs and endpoints.

* [Checkout API](https://docs.adyen.com/api-explorer/Checkout/latest/overview)
* [Management API](https://docs.adyen.com/api-explorer/Management/latest/overview)

For a full overview of supported endpoints, see the list on [GitHub](https://github.com/Adyen/adyen-mcp/tree/main?tab=readme-ov-file#adyen-mcp-server---alpha).

To get started:

1. [Get your API credentials](#get-api-credentials) to authenticate the API requests you will make with our MCP server.
2. [Run the MCP server](#run).
3. [Use our MCP](#use) with an LLM client to interact with our APIs using natural language.

## Get your API credentials

To authenticate the requests you will make using the MCP, [generate an API key](/development-resources/api-credentials#generate-api-key). You will need your API key when [running the MCP server](#run).

Make sure that your API credential has the following [roles](/development-resources/api-credentials/roles), these roles are assigned to all web service users by default:

* Merchant PAL webservice role
* Checkout webservice role
* Management API—Payment methods read
* Management API—Account read
* Management API - Terminals read
* Management API — Assign Terminal
* Management API — Terminal actions read
* Management API — Terminal actions read and write
* Management API — Android files read
* Management API — Terminal settings read
* Management API — Terminal settings read and write

## Run the MCP server

Run our MCP server locally to start interacting with our APIs using natural language. You need your API key to run the server, and authenticate API requests.

### Test environment

You must have the following to run the MCP server for the test environment:

* Your [Adyen API key](/development-resources/api-credentials/).

Run the following command:

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

### Live environment

You must have the following to run the MCP server for the live environment:

* Your [Adyen API key](/development-resources/api-credentials/).
* Your [Adyen live URL prefix](/development-resources/live-endpoints/#live-url-prefix) from your [live Customer Area](https://ca-live.adyen.com/) under **Developers** > **API URLs** > **Prefix**.

Run the following command:

```text
npx -y @adyen/mcp --adyenApiKey=ADYEN_API_KEY --env=LIVE --livePrefix=YOUR_PREFIX_URL
```

## Use the MCP server

After you start running the MCP server locally, use an LLM client of your choice to interact with our APIs using natural language.

Interactions with our MCP server consist of the following:

* **Your prompt**: You provide instructions to your LLM client using natural language. For example, "Refund order #12345" or "Create a €50 payment link for order #ABC789."
* **LLM client**: Your LLM client sends these instructions to the Adyen MCP server.
* **The MCP server**: Our MCP server uses converts these instructions into the specific Adyen API requests needed to perform the task using function calling.
* **API request**: The MCP server makes the API requests to carry out the task you asked for, like making a refund or creating a payment link.

## See also

* [API credentials](/development-resources/api-credentials/)
* [Adyen on GitHub](https://github.com/Adyen)
