MCP Server
Connect your AI-powered workflow to Localpayment's live API spec and documentation using the Model Context Protocol (MCP). Setup instructions for Cursor, VS Code, Claude, Windsurf, ChatGPT, Gemini CLI, JetBrains, and more.
The Localpayment MCP Server gives any MCP-compatible AI tool direct access to the live API specification and documentation. Once configured, your AI assistant can discover endpoints, read parameter schemas, search guides, and generate accurate integration code — grounded in the current spec, not in potentially outdated training data.
Quick start: The Localpayment MCP Server is available at
https://docs.localpayment.com/mcp. It is public and requires no authentication.
What is MCP?
Model Context Protocol (MCP) is an open standard that works like a USB port for AI — it gives AI assistants a standardized way to connect to external data sources and tools. Instead of relying on a static, potentially outdated training snapshot of the API, your AI tool queries the live Localpayment documentation in real time.
Connect to the MCP Server
Select your AI tool to get the configuration:
Or add manually to ~/.cursor/mcp.json:
{
"mcpServers": {
"localpayment": {
"url": "https://docs.localpayment.com/mcp"
}
}
}Restart Cursor and open the AI chat. The Localpayment tools will be available automatically.
Available Tools
Once connected, your AI assistant has access to the following tools:
| Tool | Description | Example use |
|---|---|---|
list-endpoints | Lists all API paths and their HTTP methods with summaries, organized by path | "What endpoints are available for virtual accounts?" |
get-endpoint | Returns full details for a specific endpoint: parameters, request body, response schemas, and security | "Show me the full spec for the Create Virtual Account endpoint" |
search-endpoints | Deep search through paths, operations, and component schemas by keyword — use to discover endpoints by capability or data model | "Find all operations related to aliases" |
search | Searches guide pages by query, returning a list of results with ID, title, and URL | "Find the guide about CVU aliases in Argentina" |
fetch | Retrieves the complete content of a guide page by ID — use search first to obtain the ID | "Get the full content of the Virtual Accounts Overview" |
The
execute-requesttool is not enabled on the Localpayment MCP Server. The server is read-only — it provides access to documentation and spec information, but does not execute API calls on your behalf. To run live requests during development, use Postman Collection or your own HTTP client with Stage credentials.
Verify Your Setup
Once configured, open your AI tool's chat or agent interface and use the following prompt to confirm the MCP server is connected and get a complete overview of the Localpayment API:
Using the Localpayment MCP tools, explore the full API and give me a
complete overview of everything available: list all endpoints organized
by product area (PayIns, PayOuts, Virtual Accounts, Treasury/FX, etc.),
explain what each major feature does, identify which countries are
supported, and explain the key integration patterns. I want a full map
of the API as my starting point before building my integration.
Your AI assistant will invoke the MCP tools (list-endpoints, search, fetch) and return a structured summary from the live Localpayment documentation.
The
fetchtool requires a guide ID, not a URL. Usesearchfirst to find the guide and obtain its ID, then pass that ID tofetchto retrieve the full content. Example: search for "virtual accounts overview" → get IDlocalpayment/virtual-accounts-overview→ fetch with that ID.
Troubleshooting
The MCP server is not connecting
- Verify the URL is exactly
https://docs.localpayment.com/mcpwith no trailing slash variations. - Ensure your editor or tool supports HTTP transport for MCP (as opposed to stdio-only). All configurations on this page use HTTP.
- Restart your editor after saving the configuration file.
- Check your network connection and confirm you can reach
https://docs.localpayment.comin a browser.
The AI assistant is not using the MCP tools
- Some editors require you to explicitly enable MCP tools in the chat settings or agent mode.
- In Cursor, ensure you are using Agent mode (not Ask mode) for tool calls to be available.
- In VS Code with Copilot, verify that the MCP extension is installed and the server appears as connected in the settings.
The tools return outdated or unexpected information
- The MCP server reflects the current published version of the Localpayment documentation. If you believe there is a discrepancy, contact [email protected].
Next Steps
Updated about 11 hours ago
