POS Terminal Management API MCP Server
The POS Terminal Management API is a comprehensive suite of endpoints designed for the administrative control and oversight of point-of-sale payment terminal fleets.
Quick Start Summary
The POS Terminal Management API MCP server is a Model Context Protocol bridge that connects AI assistants — including Claude Desktop, Cursor, Windsurf, and VS Code Copilot — to the POS Terminal Management API API through natural language. It exposes 5 API endpoints as callable tools, such as Assign terminals, Get the account or store of a terminal, Get the stores of an account, and more. 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-tfmapiservice. This integration is sourced from the auto POS Terminal Management API OpenAPI specification (v1) and has a quality score of 28/99 (fair documentation coverage).
Server Details
- Category
- Finance & Payments
- Authentication
- None
- Endpoints
- 5 operations
- Transport
- STDIO
- Spec Version
- v1
- Install Command
npx -y @mcp/adyen-com-tfmapiservice
Environment Variables
POS_TERMINAL_MANAGEMENT_API_API_KEYExample: your_pos_terminal_management_api_api_key
Top Endpoints
/assignTerminalsAssign terminals
/findTerminalGet the account or store of a terminal
/getStoresUnderAccountGet the stores of an account
/getTerminalDetailsGet the details of a terminal
/getTerminalsUnderAccountGet the list of terminals
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-tfmapiservice": {
"command": "npx",
"args": [
"-y",
"@mcp/adyen-com-tfmapiservice"
],
"env": {
"POS_TERMINAL_MANAGEMENT_API_API_KEY": "your_pos_terminal_management_api_api_key"
}
}
}
}Cursor
Settings → MCP Servers → Add
{
"mcpServers": {
"adyen-com-tfmapiservice": {
"url": "https://mcpbridge.org/config/adyen-com-tfmapiservice.json"
}
}
}Saves as .cursor/mcp.json in the download. Move it to your project root.
VS Code
Use with MCP extension
{
"mcpServers": {
"adyen-com-tfmapiservice": {
"url": "https://mcpbridge.org/config/adyen-com-tfmapiservice.json"
}
}
}Endpoints Explorer
Search and browse the 5 operations supported by this server.
Multi-Language Code Examples
Executable code snippets for calling POS Terminal Management API endpoints in curl, TypeScript, or Python.
curl -X POST "https://api.apis.guru/v2/specs/adyen.com/TfmAPIService/1/assignTerminals" \ -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-tfmapiservice": {
"command": "npx",
"args": ["-y","@mcp/adyen-com-tfmapiservice"],
"env": {
"POS_TERMINAL_MANAGEMENT_API_API_KEY": "your_pos_terminal_management_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 POS Terminal Management 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: v1
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.
findTerminal and getTerminalDetails calls seamlessly.getTerminalsUnderAccount and getTerminalDetails to compile this insight. Another powerful use case is batch provisioning or reallocation; a user could command, "Reassign the five terminals currently mapped to Store 112 to the new flagship Store 150," prompting the AI to use findTerminal to locate the specific devices and then execute multiple assignTerminal calls. This transforms high-level administrative instructions into actionable, auditable workflows, reducing manual console time and potential for error.findTerminal, getTerminalDetails, getTerminalsUnderAccount), while an automated provisioning service would additionally require write permissions for assignTerminal. Developers must ensure all communication is over TLS, store secrets securely outside of code repositories, and implement proper logging and monitoring for all API calls made by the AI agent to maintain an audit trail for compliance and debugging.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 BinLookup API MCP Setup
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. At its core, this API allows developers to submit a payment card's Bank Identification Number (BIN)—the first six to eight digits of a card number—to retrieve essential metadata that is pivotal for payment processing and risk assessment. The two primary endpoints, GET3DSAvailability and GETCostEstimate, serve distinct yet complementary purposes. The former checks for 3D Secure 2.x compatibility, determining whether an issuer supports this fraud-prevention protocol and which authentication version is applicable. The latter provides a real-time cost estimate for processing a transaction, factoring in the card's country, brand, and issuing bank to calculate interchange fees and scheme costs. Typical use cases are widespread in enterprise e-commerce and subscription billing platforms, where dynamically routing payments, pre-qualifying transactions for specific authentication methods, and providing upfront cost transparency to consumers can significantly reduce cart abandonment and optimize profitability.