Costa Rica Payments (ONVO Pay — SINPE Movil)

Official2 tools

by junter1989k-ai · JavaScript

Costa Rica payments for AI agents — SINPE Movil via ONVO Pay. Never holds funds.

Costa Rica Payments MCP is an MCP server that enables AI agents to accept payments in Costa Rica. It routes payments through SINPE Movil using ONVO Pay, and is designed to never hold funds. The server exposes 2 tools.

🛠️ Key Features

Costa Rica payment support for AI agents
Uses SINPE Movil via ONVO Pay
Never holds funds

🚀 Use Cases

Accepting Costa Rica payments in an MCP-enabled agent
Integrating payment flows for agents such as Claude and other MCP-capable setups (via MCP client configuration)

⚡ Developer Benefits

No installation steps mentioned
Credentials (when needed) are sent as HTTP headers on each request and are never stored

⚠️ Limitations

Payment handling is specific to Costa Rica and the SINPE Movil via ONVO Pay flow

Topics

ai-agentclaudecosta-ricamcpmcp-serverpaymentswishpool

Captured live from the server via tools/list.

create_payment_link

Create a payment link in CRC for Costa Rica via ONVO Pay. Buyer pays with cards, SINPE Movil — via ONVO Pay. Returns a hosted checkout URL the buyer opens to pay — payment completes automatically, no confirm step. Bring your own credentials via HTTP header (x-onvo-secret-key; free test credentials from dashboard.onvopay.com never move real money). Money always flows buyer→ONVO Pay→merchant; this service never touches funds.

Parameters4

amount_crc	integer	required	Amount in CRC (integer), e.g. 5000. Minimum 500.
description	string	required	What this payment is for (shown to the buyer, ≤200 chars)
customer_email	string	optional	Optional buyer email.
success_url	string	optional	Optional https URL to send the buyer to after payment.

Raw schema

{
  "type": "object",
  "properties": {
    "amount_crc": {
      "type": "integer",
      "minimum": 500,
      "maximum": 100000000,
      "description": "Amount in CRC (integer), e.g. 5000. Minimum 500."
    },
    "description": {
      "type": "string",
      "description": "What this payment is for (shown to the buyer, ≤200 chars)"
    },
    "customer_email": {
      "type": "string",
      "description": "Optional buyer email."
    },
    "success_url": {
      "type": "string",
      "description": "Optional https URL to send the buyer to after payment."
    }
  },
  "required": [
    "amount_crc",
    "description"
  ]
}

query_payment_status

Check whether a Costa Rica payment (created by create_payment_link) has been paid. Queries ONVO Pay directly — pull-based, no webhook needed. paid=true when status is PAID.

Parameters1

payment_link_id

string

required

The payment link id returned by create_payment_link

Raw schema

{
  "type": "object",
  "properties": {
    "payment_link_id": {
      "type": "string",
      "description": "The payment link id returned by create_payment_link"
    }
  },
  "required": [
    "payment_link_id"
  ]
}

README.md2 KBView on GitHub

Costa Rica Payments MCP — let AI agents accept payments in Costa Rica

Use it in 60 seconds

Paste this into your MCP client config (Claude Desktop, Cursor, Windsurf, or any MCP-capable agent):

json

{
  "mcpServers": {
    "costa-rica-payments": {
      "type": "http",
      "url": "https://mcp-cr.wishpool.app/mcp"
    }
  }
}

Nothing to install. Credentials, when you need them, travel as HTTP headers on each request and are never stored — see the threat model.

Or run it yourself

Would you rather not send production credentials to a server you do not control? Deploy this identical code to your own account and point your agent at your own URL:

bash

git clone https://github.com/junter1989k-ai/costa-rica-payments-mcp && cd costa-rica-payments-mcp && npx vercel --prod

MIT-licensed. Self-hosting removes us from the picture entirely, at no cost and with no loss of function.

Live · MCP endpoint: https://mcp-cr.wishpool.app/mcp · Listed on the official MCP Registry as app.wishpool/costa-rica-payments-mcp · Part of a 81-country family — hub: mcp.wishpool.app

A remote MCP server that lets any AI agent (Claude, ChatGPT, Cursor…) accept payments in Costa Rica: cards, SINPE Movil — via ONVO Pay — via ONVO Pay's hosted checkout.

⚖️ Stateless translation layer: funds always flow buyer → ONVO Pay → merchant directly. Never holds funds or stores credentials — no database at all.

Quick start

MCP endpoint: https://mcp-cr.wishpool.app/mcp (Streamable HTTP, stateless JSON-RPC)

Header	Value
`x-onvo-secret-key`	your ONVO Pay secret key from dashboard.onvopay.com (test keys = test mode)

Tools

Tool	What it does
`create_payment_link`	Create a CRC hosted-checkout link.
`query_payment_status`	Pull-based status check; `paid=true` when PAID.

Develop

bash

node test/serve.js      # local server (http://localhost:3288/mcp)
node test/e2e.js        # protocol + validation suite (probes real ONVO Pay auth errors)

Zero runtime dependencies; Node ≥ 18. MIT license.

Install

Tools (2)

create_payment_linkquery_payment_status

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://mcp-cr.wishpool.app/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json