CobroYa
Cobra con Mercado Pago en 10 segundos.
Power your agent
Perintah milik penerbit sendiri. Bukan endpoint PlugMCP.
Host a copy with our keys and logs.
npx -y [email protected]Claude Code tidak punya tautan instal untuk perintah lokal. Salin perintah di bawah dan jalankan di terminal.
MERCADO_PAGO_ACCESS_TOKEN=<secret> claude mcp add io.github.dan1d-cobroya -- npx -y cobroya@1.0.1Jalankan di terminal.
{ "mcpServers": { "io.github.dan1d-cobroya": { "command": "npx", "args": [ "-y", "[email protected]" ], "env": { "MERCADO_PAGO_ACCESS_TOKEN": "<secret>" } } }}claude_desktop_config.json
URL remote atau perintah di mesin Anda? Perbedaan kedua cara instal
Jalankan di PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
BukaCobroYa is an open-source Mercado Pago payment tool for AI agents, Telegram, WhatsApp, and automation platforms. Create payment links, search payments, issue refunds -- all from your AI assistant or chat bot.
CobroYa is an MCP (Model Context Protocol) server. Add it to your AI tool in one step -- no cloning, no building. Just provide your Mercado Pago access token.
Add to your claude_desktop_config.json:
{
"mcpServers": {
"cobroya": {
"command": "npx",
"args": ["-y", "cobroya"],
"env": {
"MERCADO_PAGO_ACCESS_TOKEN": "APP_USR-..."
}
}
}
}
claude mcp add cobroya -- npx -y cobroya \
--env MERCADO_PAGO_ACCESS_TOKEN=APP_USR-...
Add to .cursor/mcp.json in your project root:
{
"mcpServers": {
"cobroya": {
"command": "npx",
"args": ["-y", "cobroya"],
"env": {
"MERCADO_PAGO_ACCESS_TOKEN": "APP_USR-..."
}
}
}
}
Add to your Windsurf MCP configuration:
{
"mcpServers": {
"cobroya": {
"command": "npx",
"args": ["-y", "cobroya"],
"env": {
"MERCADO_PAGO_ACCESS_TOKEN": "APP_USR-..."
}
}
}
}
Once configured, ask your AI assistant things like: "Create a payment link for $5000 for a Python course" or "Show me today's approved payments".
CobroYa exposes 5 MCP tools that any connected AI agent can call:
CobroYa includes a ready-to-use Telegram bot: @CobroYa_bot
export MERCADO_PAGO_ACCESS_TOKEN="APP_USR-..."
export TELEGRAM_BOT_TOKEN="your-telegram-bot-token"
npx cobroya-telegram
Or from source:
npm run bot
CobroYa supports WhatsApp Business Cloud API for receiving commands and sending payment notifications.
export WHATSAPP_ACCESS_TOKEN="your-meta-graph-api-token"
export WHATSAPP_PHONE_NUMBER_ID="your-phone-number-id"
export WHATSAPP_VERIFY_TOKEN="your-webhook-verify-token"
npm run whatsapp
# Starts on http://localhost:3000/webhook
ngrok http 3000) and configure the webhook URL in your Meta Dashboard.For full details on supported commands and payment notifications, see the WhatsApp documentation.
Pre-built packages for popular automation platforms are available in the packages/ directory:
packages/n8n-nodes-mercadopagopackages/zapier-mercadopagopackages/make-mercadopagopackages/pipedream-mercadopagoEach package wraps the CobroYa core with platform-specific configuration. See the README in each package for setup instructions.
pip install langchain-mercadopago
from langchain_mercadopago import create_mercadopago_tools
tools = create_mercadopago_tools("APP_USR-...")
# Use with any LangChain agent
from langchain.agents import initialize_agent, AgentType
from langchain_openai import ChatOpenAI
agent = initialize_agent(
tools=tools,
llm=ChatOpenAI(model="gpt-4"),
agent=AgentType.OPENAI_FUNCTIONS,
)
agent.run("Create a payment link for $5000 for a Python course")
npm install openai-mercadopago
import { createMercadoPagoExecutor } from "openai-mercadopago";
const executor = createMercadoPagoExecutor(process.env.MERCADO_PAGO_ACCESS_TOKEN!);
// Pass executor.definitions to OpenAI's tools parameter
const response = await openai.chat.completions.create({
model: "gpt-4",
messages,
tools: executor.definitions,
});
// Execute the tool call
const result = await executor.handleToolCall(
toolCall.function.name,
JSON.parse(toolCall.function.arguments),
);
Install as a dependency:
npm install cobroya
import { createMercadoPagoTools } from "cobroya";
const mp = createMercadoPagoTools(process.env.MERCADO_PAGO_ACCESS_TOKEN!);
// Create a payment link
const pref = await mp.tools.create_payment_preference({
title: "Premium Plan",
quantity: 1,
currency: "ARS",
unit_price: 5000,
});
console.log(pref.init_point); // Checkout URL to share with the buyer
// Search approved payments
const payments = await mp.tools.search_payments({ status: "approved", limit: 10 });
// Get payment details
const payment = await mp.tools.get_payment({ payment_id: "123456789" });
// Full refund
await mp.tools.create_refund({ payment_id: "123456789" });
// Partial refund
await mp.tools.create_refund({ payment_id: "123456789", amount: 500 });
// Merchant profile
const merchant = await mp.tools.get_merchant_info();
import { MercadoPagoError } from "cobroya";
try {
await mp.tools.get_payment({ payment_id: "invalid" });
} catch (err) {
if (err instanceof MercadoPagoError) {
console.log(err.status); // 404
console.log(err.isNotFound); // true
console.log(err.isUnauthorized); // false
console.log(err.isRateLimited); // false
}
}
# Install dependencies
npm install
# Build
npm run build
# Run all tests
npm test
# Run tests with coverage
npm run test:coverage
# Watch mode
npm run test:watch
# Type-check without emitting
npx tsc --noEmit
# Integration test against real Mercado Pago API
MERCADO_PAGO_ACCESS_TOKEN=APP_USR-... npm run integration
# Start the unified server (Telegram + WhatsApp + webhooks)
npm start
# Dev mode with auto-reload
npm run dev:server
# Docker
docker compose up -d
Mercado Pago payments for AI agents: payment links, search, refunds, merchant info.
{ "mcpServers": { "io.github.dan1d-cobroya": { "command": "npx", "args": [ "-y", "[email protected]" ], "env": { "MERCADO_PAGO_ACCESS_TOKEN": "<secret>" } } }}Tool
Belum ada daftar tool. Server remote mendapatkannya setelah pemeriksaan kesehatan pertama.
FAQ
Salin konfigurasi stdio untuk Cursor, Claude Desktop, Claude Code, atau VS Code di halaman ini. Konfigurasi ini memakai instalasi dari penerbit, bukan proxy PlugMCP.
Penerbit mencantumkan variabel lingkungan berikut: MERCADO_PAGO_ACCESS_TOKEN.
Cobroya berjalan secara lokal melalui stdio.
Terakhir diperiksa 2026-11-09. Mercado Pago payments for AI agents: payment links, search, refunds, merchant info.