Adyen Test Cards APIMCP Configuration & Schema Registry
The Adyen Test Cards API Model Context Protocol (MCP) configuration provides a validated, machine-readable JSON schema and executable bridge that connects state-of-the-art AI coding assistants — including Claude Desktop, Cursor IDE, Windsurf, Cline, and VS Code Copilot — directly to the Adyen Test Cards API REST API. By leveraging the standardized open Model Context Protocol, AI agents can dynamically discover capabilities, validate input parameters against strict JSON Schemas, and execute live API operations without context switching or manual copy-pasting.
Quick Specs & Integration Summary
Technical Architecture & Protocol Semantics
Under the Model Context Protocol specification, the Adyen Test Cards API configuration functions as an isolated protocol adapter. When an AI agent initializes a session, the client establishes a bidirectional JSON-RPC 2.0 communication channel over standard input/output (stdio) or Server-Sent Events (SSE). During the initial handshake, the server publishes its tool manifest extracted from the Adyen Test Cards API OpenAPI specification (version 1).
The Adyen Test Cards API, provided by the global payment platform Adyen, is a specialized utility designed to streamline the payment integration development and testing lifecycle. Its core capability is the programmatic generation of custom test card numbers, a critical requirement for developers and QA engineers building and validating payment flows in sandbox or test environments. By exposing a dedicated endpoint, `POST /createTestCardRanges`, the API eliminates the manual process of sourcing static test card numbers from documentation or community lists. This is particularly valuable for enterprise-scale applications where testing must cover a complex matrix of scenarios, including various card schemes (Visa, Mastercard, etc.), card types (credit, debit, prepaid), issuer countries, and specific transaction outcomes like approvals, declines, and 3D Secure challenges. Typical use cases span from automated continuous integration (CI) pipelines that require unique test data for each run, to teams developing payment interfaces that must simulate a wide array of real-world customer payment methods. Exposing this API as a tool via the Model Context Protocol (MCP) transforms it into a powerful, dynamic resource for AI-powered coding assistants like Claude Desktop, Cursor, or Cline. The primary value lies in automating and contextualizing a previously manual and context-switching task. Instead of a developer having to leave their IDE to visit the Adyen docs, copy a card number, and then return to write a test case, they can delegate this to the AI agent. The agent gains the ability to "think" with test data as a first-class citizen. For example, a developer can instruct the AI to generate a complete, realistic test suite for a new checkout feature. The AI can then dynamically call the `createTestCardRanges` endpoint to procure the exact test cards needed for specific test cases—such as a German Visa card for a successful payment test and a US Mastercard configured to trigger a 3DS challenge—all within the same conversational or scripted workflow. This creates a more fluid, efficient, and less error-prone development process. Practical workflows enabled by this MCP integration are numerous and directly accelerate development. A developer could issue a command like, "Create a Jest test file for our payment form that validates successful and failed transactions." The AI agent would not only scaffold the test file but also proactively use the Test Cards API to populate it with a fresh set of dynamic test card numbers for each scenario. Another workflow involves updating an existing test suite: "Our testing has identified that we need to cover more issuer country variations. Update the payment simulation tests to include cards from Brazil, Japan, and the UK." The agent would then generate and insert the appropriate test cards into the relevant test files. Furthermore, for compliance or 3D Secure testing, a developer could request, "Generate a set of test cards specifically for testing Visa Secure authentication," and the agent would provide a curated list ready for integration. This turns the AI from a code generator into a contextual test data engineer. While the `POST /createTestCardRanges` endpoint itself does not require authentication, its integration within a broader development ecosystem must adhere to strict security best practices. Developers should treat the generated test card data as confidential to their sandbox environment and never commit it to public version control. When setting up an MCP server that exposes this tool, it is critical to configure it with the principle of least privilege; the server should only have network access to Adyen's sandbox API endpoints and nowhere else. If the MCP server requires a general Adyen API key for other operations, that key should be a dedicated test account key with minimal permissions. Rate limiting should be configured to prevent excessive calls to the Adyen endpoint. All configuration, especially API keys and server endpoints, must be managed through secure environment variables or secret management services, never hardcoded. Developers should also be aware that while the generated cards are for testing, they are modeled on real card number structures and must be handled with the same respect for data privacy as live payment data within their internal systems. This architecture guarantees strict process boundary isolation: all sensitive authorization headers and secret tokens remain sandboxed inside the client runtime, never leaking into language model context windows or external logging endpoints.
Hosted Remote Configuration URL
MCP Configuration FileProvide this hosted URL in any client that supports remote MCP schema auto-loading.
https://mcpbridge.org/config/adyen-com-testcardservice.json2. AI Assistant Use Cases & Practical Workflows
Tailored for ProductivityReal-world execution scenarios demonstrating how LLM agents (Claude 3.7, GPT-4o, Cursor Agent) invoke Adyen Test Cards API tools to automate developer workflows.
1. Automated Incident Escalation & Notification Routing
Incident CommsBroadcast priority notifications with rich incident context, system health metrics, and on-call engineer assignment details.
"Dispatch a high-priority incident notification via Adyen Test Cards API containing the latest stack trace, affected microservice names, and link to the active monitoring dashboard."
2. Knowledge Base & Workspace Documentation Sync
Knowledge SyncSynchronize newly merged pull request documentation and architectural decision records into searchable workspace hubs.
"Fetch updated technical notes from our repository and sync them into Adyen Test Cards API. Ensure headers, code blocks, and parameter tables are correctly formatted in markdown."
3. Omnichannel Customer Ticket Triaging & Sentiment Analysis
Support AutomationClassify incoming customer inquiry tickets, detect customer sentiment urgency, and auto-draft contextual solution proposals.
"Retrieve open customer support tickets from Adyen Test Cards API. Classify urgency based on customer sentiment and generate drafted reply outlines for Tier-2 engineering review."
4. Scheduled Webhook Dispatch & Event Orchestration
Event OrchestrationAutomate event notification triggers when deployments complete, staging builds pass, or schema changes are detected.
"Configure an event notification hook in Adyen Test Cards API to trigger Slack updates whenever a high-severity deployment event is logged in staging."
End-to-End Multi-Step Agent Execution Lifecycle
When an engineer submits a task to Claude Desktop or Cursor, the LLM executes an autonomous 4-phase Model Context Protocol loop:
Schema Introspection
Handshake lists all 1 tools and builds argument validators.
Argument Synthesis
Model extracts parameters from prompt and validates types against OpenAPI rules.
Stdio Execution
Bridge invokes live API with injected local credentials and captures raw HTTP response.
Output Remediation
LLM parses JSON results, handles status codes, and presents synthesized answers.
3. Multi-Client Installation Matrix & Setup Guides
Select your AI assistant below to view exact configuration file paths, JSON installation snippets, and launch commands.
Claude Desktop
claude_desktop_config.json~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.json~/.config/Claude/claude_desktop_config.json{
"mcpServers": {
"adyen-com-testcardservice": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-openapi",
"https://api.apis.guru/v2/specs/adyen.com/TestCardService/1/openapi.json"
],
"env": {
"ADYEN_TEST_CARDS_API_API_KEY": "your_adyen_test_cards_api_api_key"
}
}
}
}Cursor IDE
.cursor/mcp.jsonOpen Cursor Settings → Features → MCP Servers, or create .cursor/mcp.json in your project root.
{
"mcpServers": {
"adyen-com-testcardservice": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-openapi",
"https://api.apis.guru/v2/specs/adyen.com/TestCardService/1/openapi.json"
],
"env": {
"ADYEN_TEST_CARDS_API_API_KEY": "your_adyen_test_cards_api_api_key"
}
}
}
}Saves as .cursor/mcp.json in the download. Move it to your project root.
VS Code / Cline Extension
cline_mcp_settings.jsonPaste into your Cline extension MCP configuration or Roo Code host settings.
{
"mcpServers": {
"adyen-com-testcardservice": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-openapi",
"https://api.apis.guru/v2/specs/adyen.com/TestCardService/1/openapi.json"
],
"env": {
"ADYEN_TEST_CARDS_API_API_KEY": "your_adyen_test_cards_api_api_key"
}
}
}
}Zed Editor & Docker CLI
Zed / DockerDocker container execution command:
docker run -i --rm -e ADYEN_TEST_CARDS_API_API_KEY="YOUR_SECRET_VALUE" node:20-alpine npx -y @modelcontextprotocol/server-openapi https://api.apis.guru/v2/specs/adyen.com/TestCardService/1/openapi.json
Zed settings context servers JSON:
{
"context_servers": {
"adyen-com-testcardservice": {
"command": {
"path": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-openapi",
"https://api.apis.guru/v2/specs/adyen.com/TestCardService/1/openapi.json"
],
"env": {
"ADYEN_TEST_CARDS_API_API_KEY": "your_adyen_test_cards_api_api_key"
}
}
}
}
}Programmatic SDK Integration (TypeScript / Python)
Initialize the Adyen Test Cards API MCP client directly in your backend codebase.
import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
// Initialize Adyen Test Cards API MCP client transport over stdio
const transport = new StdioClientTransport({
command: "npx",
args: ["-y","@modelcontextprotocol/server-openapi","https://api.apis.guru/v2/specs/adyen.com/TestCardService/1/openapi.json"],
env: { ADYEN_TEST_CARDS_API_API_KEY: process.env.ADYEN_TEST_CARDS_API_API_KEY || "YOUR_SECRET_KEY" }
});
const client = new Client(
{ name: "adyen-com-testcardservice-client", version: "1.0.0" },
{ capabilities: { tools: {}, resources: {}, prompts: {} } }
);
async function connectAndRun() {
await client.connect(transport);
const tools = await client.listTools();
console.log("Connected to Adyen Test Cards API MCP Server.");
console.log("Discovered 1 mapped tools:", tools);
}
connectAndRun().catch(console.error);Raw Stdio Schema Definition
schema.jsonFor standalone CLI wrappers, background daemon daemons, or custom script integrations:
{
"mcpServers": {
"adyen-com-testcardservice": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-openapi",
"https://api.apis.guru/v2/specs/adyen.com/TestCardService/1/openapi.json"
],
"env": {
"ADYEN_TEST_CARDS_API_API_KEY": "your_adyen_test_cards_api_api_key"
}
}
}
}4. Security, Authentication & Credential Management
Safely configure authentication tokens, isolate execution environments, and implement enterprise security best practices.
Required Environment Keys Reference
| Variable Name | Required | Type | Default | Purpose & Guidance |
|---|---|---|---|---|
| ADYEN_TEST_CARDS_API_API_KEY | REQUIRED | Secret Key / Token | None (Set in env) | your_adyen_test_cards_api_api_key |
Zero-Downtime Token Rotation Protocol
- Generate Secondary Key: Create a new secret API token with identical scopes in your Adyen Test Cards API developer portal.
- Update Client Configuration: Insert the new token inside the
envblock of your MCP client JSON config. - Validate Connection: Issue a test query in Claude or Cursor to ensure handshake and tool calls succeed.
- Revoke Stale Token: Decommission the legacy key on the vendor portal to prevent unauthorized access.
Least-Privilege & Sandboxing Rules
- Read-Only Token Scoping: Whenever your workflow only requires querying data, provision read-only credentials to prevent accidental mutations.
- Local Process Isolation: Stdio transports run in isolated local subprocesses; secret credentials are never sent across the internet to MCP Bridge servers.
- Prompt Injection Defense: AI model responses are sandboxed; verify generated destructive arguments before confirming execution in agent mode.
Enterprise Security Checklist (Mandatory Practices)
- Never commit
claude_desktop_config.jsonor.cursor/mcp.jsoncontaining raw secrets into public GitHub repositories. - Add
.cursor/mcp.jsonand.env.localto your project's.gitignorefile. - Always enforce TLS/HTTPS encryption on outbound network requests initiated by the server process.
5. Tool Parameter Schemas & Natural Language Execution
Mapped OpenAPI operations converted into discrete Model Context Protocol tools with strict JSON-RPC payload validators.
/createTestCardRangesCreates one or more test card ranges.
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "adyen-com-testcardservice_post_createTestCardRanges",
"arguments": {}
}
}"Use Adyen Test Cards API to execute Creates one or more test card ranges. and output the formatted result."
6. Interactive Troubleshooting & FAQ Accordion
Diagnose and resolve common JSON-RPC protocol error codes, connection disconnects, and schema refresh issues.
A 401 Unauthorized response indicates that the upstream Adyen Test Cards API API rejected the authentication credential supplied in your MCP client's environment configuration. To resolve this: (1) Verify that your secret token is defined inside the "env" block of claude_desktop_config.json or .cursor/mcp.json rather than hardcoded in the command string. (2) Check whether Adyen Test Cards API requires a prefix such as "Bearer <token>" in the authorization header. (3) Confirm that your API key has not expired and has been granted sufficient least-privilege scopes on the Adyen Test Cards API developer dashboard.
If your MCP client fails to initialize tools for Adyen Test Cards API: (1) Test the bridge launcher command ("npx -y @modelcontextprotocol/server-openapi https://api.apis.guru/v2/specs/adyen.com/TestCardService/1/openapi.json") directly inside your terminal or shell to inspect stdout/stderr diagnostic traces. (2) Verify network connectivity to the schema source (https://api.apis.guru/v2/specs/adyen.com/TestCardService/1/openapi.json). (3) Ensure Node.js (v18+) is installed and accessible in your system PATH. (4) For authenticated APIs, confirm credentials are configured in your client's "env" mapping rather than command arguments.
MCP clients like Claude Desktop and Cursor query the server's tools list ("tools/list") during startup and cache the resulting JSON Schema for the duration of the application session. If new endpoints or parameters are added to Adyen Test Cards API: (1) Fully quit and restart Claude Desktop (Cmd+Q on macOS or File > Exit on Windows). (2) In Cursor IDE, navigate to Settings > Features > MCP Servers, toggle the Adyen Test Cards API server off and on, or click the refresh icon to re-execute the initialization handshake.
If the AI model hallucinates parameters or fails to invoke a tool automatically: (1) Add explicit system instructions in your project's .cursorrules or Claude project prompt (e.g., "When querying Productivity, always invoke the adyen-com-testcardservice MCP server tools first"). (2) Ensure parameter types match schema specifications (e.g., passing integers as numbers rather than strings). (3) Check that required parameters marked in Section 5 are not omitted from the model's generated payload.
When the Adyen Test Cards API upstream endpoint returns an HTTP 429 Too Many Requests response, the MCP server bubbles the structured error payload back to the AI client over stdio. Modern LLMs like Claude 3.7 and Cursor Agent recognize rate-limiting status codes, inspect the "Retry-After" header if present, and will automatically introduce backoff delays or ask the user before retrying the operation.
The Hosted Config URL (https://mcpbridge.org/config/adyen-com-testcardservice.json) provides a static, remote JSON schema definition that cloud-native MCP clients can fetch over HTTPS for dynamic discovery. In contrast, local stdio configurations execute a local subprocess on your workstation. Local stdio processes offer maximum security because secret API keys remain strictly on your local machine and never transit third-party proxy servers.
Similar Productivity Configurations
Explore related API bridges with ready-to-use Model Context Protocol schemas.
Notion
ProductivityCreate and manage Notion pages, databases, and blocks through your AI agent.
https://mcpbridge.org/config/notion.jsonLinear API
ProductivityManage issues, projects, and workflows in Linear through your AI agent.
https://mcpbridge.org/config/linear.jsonPlatform API
ProductivityThe Platform API is a comprehensive RESTful interface provided by Ably, a leading provider of real-time messaging and presence infrastructure, designed to give developers granular, programmatic control over their Ably applications and resources. Its core capabilities extend beyond simple pub/sub messaging, enabling the management and inspection of channels, the retrieval and publishing of messages, the manipulation of presence state for users across those channels, and the configuration of push notification subscriptions. Typical use cases span enterprise and consumer applications where real-time functionality is critical, such as live activity feeds for e-commerce platforms, collaborative tools requiring synchronized state, multi-user gaming, real-time chat, and IoT device status monitoring. This API serves as the foundational control plane for any application built on the Ably ecosystem, allowing for dynamic, server-side orchestration of real-time behaviors. When exposed as tools via the Model Context Protocol (MCP) to an AI coding assistant like Claude Desktop, Cursor, or Cline, this API gains transformative value. It transitions from a static endpoint reference to an interactive, queryable system that an AI agent can leverage to understand, debug, and extend a developer's real-time infrastructure. The AI can perform live introspection of channel activity, diagnose presence synchronization issues, or audit message flow without requiring the developer to manually construct complex cURL commands or navigate dashboards. This integration effectively turns the AI into a knowledgeable collaborator with direct, safe access to the operational state of the real-time layer, significantly accelerating troubleshooting, prototyping, and implementation of features that interact with or rely upon the messaging backbone. In practice, a developer can instruct the AI agent to perform a variety of dynamic, context-aware tasks. For instance, one might ask, "AI agent, query the recent messages on the 'user-updates' channel and summarize the last ten status changes," enabling rapid analysis of event streams. Another directive could be, "AI agent, create a new, private channel named 'group-chat-123' and configure its presence history retention to 24 hours," automating infrastructure setup. The AI can also be tasked to "check all active presence members on the 'dashboard' channel to verify if the test user is connected" for debugging, or to "remove a spam message with ID 'msg_abc' from the 'announcements' channel" for moderation. Furthermore, the AI can facilitate push notification management with commands like, "AI agent, list all device subscriptions for the 'breaking-news' channel and remove any that haven't been active in over 30 days," thus maintaining a clean and effective push subscriber list. Security and proper configuration are paramount when deploying this MCP server. Although the API specification lists authentication as "None," this refers to the public REST spec; in practice, all calls require authentication via an Ably API key or token. Developers must follow the principle of least privilege by generating scoped API keys specifically for the AI assistant tool. Keys should be assigned only the capabilities necessary for the intended tasks—such as "subscribe" and "publish" for message reading, or "channel-details" for introspection—and assigned only to the required channels or namespaces. Environment variables should be used to manage these credentials, never hardcoded. It is critical to deploy this MCP server in a secure environment and consider that enabling write operations (POST/DELETE) grants the AI agent the ability to modify state; thus, such tools should be enabled judiciously, potentially limited to development or staging environments, and always with full audit logging enabled to track AI-initiated actions.
https://mcpbridge.org/config/ably-io-platform.jsonControl API v1
ProductivityThe Control API v1, provided by Ably, is a comprehensive programmatic interface designed for the administrative management and automation of Ably’s real-time messaging infrastructure. It serves as the central nervous system for controlling core resources within an Ably account, enabling developers and platform engineers to dynamically provision and configure applications, manage authentication credentials (keys), organize message flow with namespaces, and establish operational rules. Its primary function is to transition infrastructure management from manual, dashboard-driven tasks to scalable, code-first operations. This makes it indispensable for enterprise use cases such as automated environment provisioning for development and testing, multi-tenant SaaS platforms requiring isolated customer channels, and large-scale IoT deployments where device groups (represented by namespaces) or security credentials (keys) must be managed programmatically in response to dynamic demand. The API currently operates in a Beta state, indicating it is feature-rich but subject to refinement based on developer feedback. When integrated as tools for an AI coding assistant via the Model Context Protocol (MCP), the Control API unlocks a powerful paradigm of infrastructure-as-conversation, dramatically accelerating development workflows and reducing context-switching. An AI agent, armed with these tools, becomes a co-pilot capable of directly querying and modifying your Ably topology based on natural language instructions. This transforms abstract architectural decisions into immediate, executable actions. For instance, a developer can instruct the AI to "list all applications in our account and generate a new API key scoped to the 'production' namespace for the payments service," bypassing manual dashboard navigation and potential configuration errors. The value lies in the AI's ability to understand context, chain operations (e.g., "find the app ID for 'user-service', then list its keys, and finally create a new key with read-only permissions"), and act as a contextual expert, thereby compressing development cycles and enhancing operational accuracy. Practical workflows enabled by this MCP server are numerous and directly impactful. An AI agent can perform dynamic resource auditing by querying all keys and their permissions to generate a security report, stating, "AI agent can query all keys to audit privilege distribution across namespaces." It can automate environment cleanup by instructing, "AI agent can delete all test namespaces older than 30 days to reduce clutter and costs." In a CI/CD pipeline context, a developer could prompt, "AI agent can create a temporary, restricted key for a staging environment and then revoke it after tests complete," ensuring ephemeral credentials and enforcing security hygiene. For multi-tenant management, the AI can handle customer onboarding by executing, "AI agent can create a new namespace for a new tenant, generate a scoped key, and provide the configuration details back to the provisioning system." Critical to the deployment of this API is the absence of a built-in authentication method, which mandates that developers implement and enforce robust security controls externally. Authentication and authorization must be rigorously applied, ideally using Ably API keys with the smallest possible set of privileges required for the specific task, adhering strictly to the principle of least privilege. For an MCP server integration, this means the server should be configured with a high-privilege key only in a secure, isolated backend environment, while exposing a minimal set of safe, well-vetted tools to the AI. Additional security best practices include using short-lived tokens where possible, enforcing IP allowlists on API keys, and meticulously logging all API actions for audit trails. Developers must treat the Control API as a powerful and sensitive management plane, where a misconfigured tool or overly broad permission could lead to significant operational or security incidents.
https://mcpbridge.org/config/ably-net-control.json