Adyen BinLookup API MCP Server
The Adyen BinLookup API is a critical financial data service provided by Adyen, a leading global payment platform, designed to enable merchants and payment service providers to enhance transaction decisioning and optimize payment acceptance rates.
Quick Start Summary
The Adyen BinLookup API MCP server is a Model Context Protocol bridge that connects AI assistants — including Claude Desktop, Cursor, Windsurf, and VS Code Copilot — to the Adyen BinLookup API API through natural language. It exposes 2 API endpoints as callable tools, such as Check if 3D Secure is available, Get a fees cost estimate. No authentication is required — setup takes approximately 30 seconds. The server uses STDIO transport and can be installed by running npx -y @mcp/adyen-com-binlookupservice. This integration is sourced from the auto Adyen BinLookup API OpenAPI specification (v40) and has a quality score of 28/99 (fair documentation coverage).
Server Details
- Category
- Finance & Payments
- Authentication
- None
- Endpoints
- 2 operations
- Transport
- STDIO
- Spec Version
- v40
- Install Command
npx -y @mcp/adyen-com-binlookupservice
Environment Variables
ADYEN_BINLOOKUP_API_API_KEYExample: your_adyen_binlookup_api_api_key
Top Endpoints
/get3dsAvailabilityCheck if 3D Secure is available
/getCostEstimateGet a fees cost estimate
One-Click Install
Copy the snippet for your MCP client and paste it in — zero editing required.
Claude Desktop
Add to claude_desktop_config.json
{
"mcpServers": {
"adyen-com-binlookupservice": {
"command": "npx",
"args": [
"-y",
"@mcp/adyen-com-binlookupservice"
],
"env": {
"ADYEN_BINLOOKUP_API_API_KEY": "your_adyen_binlookup_api_api_key"
}
}
}
}Cursor
Settings → MCP Servers → Add
{
"mcpServers": {
"adyen-com-binlookupservice": {
"url": "https://mcpbridge.org/config/adyen-com-binlookupservice.json"
}
}
}Saves as .cursor/mcp.json in the download. Move it to your project root.
VS Code
Use with MCP extension
{
"mcpServers": {
"adyen-com-binlookupservice": {
"url": "https://mcpbridge.org/config/adyen-com-binlookupservice.json"
}
}
}Endpoints Explorer
Search and browse the 2 operations supported by this server.
Multi-Language Code Examples
Executable code snippets for calling Adyen BinLookup API endpoints in curl, TypeScript, or Python.
curl -X POST "https://api.apis.guru/v2/specs/adyen.com/BinLookupService/40/get3dsAvailability" \ -H "Content-Type: application/json" \ # No auth required
Manual Configuration
Directly add this block to your JSON config file, or use the hosted config registry URL.
{
"mcpServers": {
"adyen-com-binlookupservice": {
"command": "npx",
"args": ["-y","@mcp/adyen-com-binlookupservice"],
"env": {
"ADYEN_BINLOOKUP_API_API_KEY": "your_adyen_binlookup_api_api_key"
}
}
}
}Authentication Details
No authentication required. This MCP server runs out-of-the-box.
Documentation Links
Error Handling & HTTP Status Code Matrix
Common status codes, error causes, and resolution steps when invoking Adyen BinLookup API endpoints.
400 Bad RequestCause: Malformed payload parameters or missing required fields.
Resolution: Verify request schema in Endpoints tab before calling tool.
401 UnauthorizedCause: Missing or invalid API key credentials.
Resolution: Set environment variable in MCP client config under env object.
403 ForbiddenCause: Insufficient scope permissions for requested resource.
Resolution: Verify key permissions in developer dashboard.
404 Not FoundCause: Resource URL path or requested entity ID does not exist.
Resolution: Check path variables and parameters.
429 Rate Limit ExceededCause: API rate limit quota exceeded.
Resolution: Implement exponential backoff retry in tool call.
500 Internal ErrorCause: Upstream server runtime fault.
Resolution: Inspect STDIO stderr output for log trace.
Quality Score
Checked against our protocol-compliance rules.
Specification Version: v40
Page compiled on: June 13, 2026
Own this API?
Verify ownership of this listing to control the description, configuration details, and documentation links. Choose between free manual verification or instant premium placement.
Option 1: Free Verification
Slow manual review. Requires creating a GitHub issue with verified documentation or domain verification.
- • Verified badge on page
- • Standard search sorting
- • 2-3 business days review
Option 2: Featured Upgrade($9/mo)
Instant verification plus premium styling, featured badges, and directory placement boost.
- • ★ Featured star & amber highlight border
- • Top of directory search placement
- • Instant activation via claim token
📖 Detailed MCP Integration Guide
A technical breakdown of capabilities, agent workflows, and security/configuration best practices.
Similar APIs
Other APIs in the Finance & Payments category.
Stripe API
Process payments, manage subscriptions, and handle billing. Let your AI agent interact with Stripe seamlessly.
API KeyStripe API
The Stripe API is a comprehensive, RESTful interface provided by Stripe, Inc. that enables developers to programmatically manage all aspects of an online payment ecosystem. Core capabilities span the entire transaction lifecycle, including accepting payments, managing subscriptions, handling disputes, processing payouts, and orchestrating complex multi-party financial workflows. The provided endpoints specifically target the Connect product, which allows platforms and marketplaces to manage connected accounts (sellers, service providers, or sub-merchants), their associated bank accounts, and account onboarding via account links. Typical enterprise use cases include building global marketplaces, gig economy platforms, SaaS with revenue sharing, and any system requiring automated, multi-stakeholder financial operations. Consumer applications might involve freelancer tools or peer-to-peer payment interfaces that leverage these account management functions.
1Forge Finance APIs
The 1Forge Finance API provides a robust, high-performance gateway to global financial market data, specializing in real-time and delayed equities and foreign exchange (Forex) quotes. As a foundational data service, it aggregates and delivers critical market information through its core endpoints: GET /quotes for retrieving current price data for specific symbols, and GET /symbols for accessing a comprehensive list of tradable assets. This API, offered by the financial data provider 1Forge, serves a vital function for developers building financial applications, trading platforms, portfolio trackers, and analytical tools. Typical use cases range from retail investors seeking live market snapshots for personal dashboards to enterprise fintech firms integrating up-to-the-moment pricing into risk management systems, algorithmic trading backtesting frameworks, or currency conversion engines for international payment services. Its value lies in providing a streamlined, dedicated source for the essential data points that underpin countless financial workflows.
Adyen Account API
The Account API is a foundational RESTful service provided by Adyen for the comprehensive management of account-related entities within a classic marketplace or platform integration. It serves as the primary programmatic interface for orchestrating the lifecycle of accounts, account holders, and their associated legal and financial components on the Adyen payments platform. Its core capabilities encompass the creation, retrieval, and deletion of critical data structures, including the accounts themselves, account holder profiles, bank accounts, legal arrangements, shareholder records, and signatory details. Typical use cases are prevalent in enterprise-grade platform operations: onboarding new merchants or sellers by creating account holders and linking their bank accounts for payouts, performing due diligence by managing legal and shareholder information, generating necessary financial documents via tax form retrieval, and finally, executing the secure closure of accounts or account holder relationships when required. This API is the engine behind programmatic account management for businesses that have already established their Adyen platform integration.
Related MCP Server Integrations
Stripe API MCP Setup
Process payments, manage subscriptions, and handle billing. Let your AI agent interact with Stripe seamlessly.
Stripe API MCP Setup
The Stripe API is a comprehensive, RESTful interface provided by Stripe, Inc. that enables developers to programmatically manage all aspects of an online payment ecosystem. Core capabilities span the entire transaction lifecycle, including accepting payments, managing subscriptions, handling disputes, processing payouts, and orchestrating complex multi-party financial workflows. The provided endpoints specifically target the Connect product, which allows platforms and marketplaces to manage connected accounts (sellers, service providers, or sub-merchants), their associated bank accounts, and account onboarding via account links. Typical enterprise use cases include building global marketplaces, gig economy platforms, SaaS with revenue sharing, and any system requiring automated, multi-stakeholder financial operations. Consumer applications might involve freelancer tools or peer-to-peer payment interfaces that leverage these account management functions.
1Forge Finance APIs MCP Setup
The 1Forge Finance API provides a robust, high-performance gateway to global financial market data, specializing in real-time and delayed equities and foreign exchange (Forex) quotes. As a foundational data service, it aggregates and delivers critical market information through its core endpoints: GET /quotes for retrieving current price data for specific symbols, and GET /symbols for accessing a comprehensive list of tradable assets. This API, offered by the financial data provider 1Forge, serves a vital function for developers building financial applications, trading platforms, portfolio trackers, and analytical tools. Typical use cases range from retail investors seeking live market snapshots for personal dashboards to enterprise fintech firms integrating up-to-the-moment pricing into risk management systems, algorithmic trading backtesting frameworks, or currency conversion engines for international payment services. Its value lies in providing a streamlined, dedicated source for the essential data points that underpin countless financial workflows.
Adyen Account API MCP Setup
The Account API is a foundational RESTful service provided by Adyen for the comprehensive management of account-related entities within a classic marketplace or platform integration. It serves as the primary programmatic interface for orchestrating the lifecycle of accounts, account holders, and their associated legal and financial components on the Adyen payments platform. Its core capabilities encompass the creation, retrieval, and deletion of critical data structures, including the accounts themselves, account holder profiles, bank accounts, legal arrangements, shareholder records, and signatory details. Typical use cases are prevalent in enterprise-grade platform operations: onboarding new merchants or sellers by creating account holders and linking their bank accounts for payouts, performing due diligence by managing legal and shareholder information, generating necessary financial documents via tax form retrieval, and finally, executing the secure closure of accounts or account holder relationships when required. This API is the engine behind programmatic account management for businesses that have already established their Adyen platform integration.
Adyen Checkout API MCP Setup
The Adyen Checkout API, provided by the global payment technology platform Adyen, serves as a unified, powerful engine for initiating and authorizing online payments across a diverse spectrum of methods. Its core capability lies in abstracting the complexity of integrating with numerous payment schemes into a single, consistent interface. Developers can process transactions from major international card networks, including those secured with 3D Secure authentication, as well as popular mobile wallets and a wide array of local payment methods like iDEAL in the Netherlands or Sofort in Germany. This makes it an indispensable tool for both enterprise e-commerce platforms seeking a scalable global solution and consumer-facing applications requiring a seamless, localized checkout experience. Typical use cases span from processing direct card payments and managing Apple Pay sessions to generating shareable payment links, canceling pending transactions, and even handling donation flows. The API endpoints like POST /orders, GET /paymentLinks/{linkId}, and POST /applePay/sessions enable businesses to orchestrate complex payment lifecycles, from order creation and method-specific session management to fulfillment tracking and cancellation.