Skip to content
MCP-Bridge
Security

Hosted onboarding API MCP Config

This API is used for the classic integration. If you are just starting your implementation, refer to our [new integration guide](https://docs.adyen.com/marketplaces-and-platforms) instead. The Hosted onboarding API provides endpoints that you can use to generate links to Adyen-hosted pages, such as

Config URL

Use this URL in any MCP-compatible client to fetch the config automatically.

https://mcp-bridge.pages.dev/config/adyen-com-hopservice.json

Configuration JSON

Use curl https://mcp-bridge.pages.dev/config/adyen-com-hopservice.json to fetch programmatically.

{
  "mcpServers": {
    "adyen-com-hopservice": {
      "command": "npx",
      "args": ["-y","@mcp/adyen-com-hopservice"],
      "env": {
      "HOSTED_ONBOARDING_API_API_KEY": "your_hosted_onboarding_api_api_key"
}
    }
  }
}

How to Use

Claude Desktop

Paste the config JSON into your claude_desktop_config.json.

Full instructions →

Cursor

Go to Cursor Settings → MCP Servers → Add with the JSON above.

CLI / curl

Fetch the config programmatically:

curl https://mcp-bridge.pages.dev/config/adyen-com-hopservice.json

Environment Variables

HOSTED_ONBOARDING_API_API_KEY

Replace your_hosted_onboarding_api_api_key with your actual hosted onboarding api api key

Endpoints

POST/getOnboardingUrl

Get a link to a Adyen-hosted onboarding page

POST/getPciQuestionnaireUrl

Get a link to a PCI compliance questionnaire