Skip to main content
Glama
paybridgenp

PayBridgeNP MCP Server

by paybridgenp

@paybridge-np/mcp

Servidor oficial del Model Context Protocol para PayBridgeNP, la pasarela de pagos nepalí.

Permite a Claude, ChatGPT, Cursor, Claude Code, VS Code — cualquier asistente de IA compatible con MCP — leer y actuar sobre tu cuenta de PayBridgeNP mediante lenguaje natural. Emite reembolsos, crea enlaces de pago, gestiona suscripciones, inspecciona webhooks fallidos, extrae KPIs; todo mediante chat.

69 herramientas. 6 plantillas de prompt integradas. Tokens con alcance limitado. Límites de gasto. Auditoría completa.

Instalación

Claude Desktop

Añádelo a ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "paybridge": {
      "command": "npx",
      "args": ["-y", "@paybridge-np/mcp@latest"],
      "env": {
        "PAYBRIDGE_API_KEY": "sk_live_..."
      }
    }
  }
}

Reinicia Claude Desktop.

Cursor

El mismo JSON en .cursor/mcp.json o a través de Ajustes → MCP.

Claude Code

claude mcp add paybridge \
  --env PAYBRIDGE_API_KEY=sk_live_... \
  -- npx -y @paybridge-np/mcp@latest

VS Code

.vscode/mcp.json:

{
  "servers": {
    "paybridge": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@paybridge-np/mcp@latest"],
      "env": { "PAYBRIDGE_API_KEY": "sk_live_..." }
    }
  }
}

Genera un token MCP con alcance limitado desde tu panel de control de PayBridgeNP. No pegues una clave REST de acceso total.

Related MCP server: PayArk MCP Server

Herramientas (69)

Lectura (31)

Categoría

Herramientas

Cuenta

get_account

Pagos

list_payments, get_payment

Reembolsos

list_refunds, get_refund

Sesiones

list_checkout_sessions, get_checkout_session

Enlaces de pago

list_payment_links, get_payment_link

Webhooks

list_webhook_endpoints, list_webhook_deliveries

Planes

list_plans, get_plan

Clientes

list_customers, get_customer

Suscripciones

list_subscriptions, get_subscription

Facturas

list_invoices, get_invoice

Cupones

list_coupons, get_coupon

Promociones

list_promotion_codes, get_promotion_code, validate_promotion_code

Impuestos

get_tax_settings

Cobranza (Dunning)

list_dunning_policies, get_dunning_invoice_status

Uso

preview_subscription_proration, get_subscription_usage_summary, list_usage_records

Análisis

get_analytics_overview

Escritura (38)

Las herramientas que mueven dinero (create_refund, cancel_subscription, delete_*) requieren confirmación explícita en la interfaz del host antes de ejecutarse.

Categoría

Herramientas

Pagos

create_checkout_session

Reembolsos

create_refund

Enlaces de pago

create_payment_link, update_payment_link, cancel_payment_link, delete_payment_link

Webhooks

create_webhook_endpoint, update_webhook_endpoint, delete_webhook_endpoint

Planes

create_plan, update_plan

Clientes

create_customer, update_customer, add_customer_credit

Suscripciones

create_subscription, pause_subscription, resume_subscription, cancel_subscription, change_subscription_plan, end_trial, extend_trial

Facturas

create_invoice_item, delete_invoice_item

Cupones

create_coupon, deactivate_coupon

Promociones

create_promotion_code, deactivate_promotion_code, apply_coupon_to_subscription, remove_subscription_discount

Impuestos

update_tax_settings

Cobranza (Dunning)

create_dunning_policy, update_dunning_policy, set_subscription_dunning_policy, stop_invoice_dunning, retry_invoice_dunning_now

Uso

report_subscription_usage, update_subscription_quantity

Prompts

6 plantillas de prompt integradas: aparecen como comandos de barra diagonal en Claude Desktop y Cursor (/ → escribe paybridge):

Prompt

Qué hace

daily_summary

Resumen de fin de día: ingresos, pagos, reembolsos, embudo de pago, fallos de webhook

monthly_reconciliation

Tabla de conciliación mensual completa lista para compartir con tu contable. Acepta el argumento opcional month (ej. 2026-04)

investigate_failed_payment

Diagnostica por qué fallaron los pagos: acepta payment_id o customer_email opcionales

onboard_customer

Crea un cliente + suscríbelo a un plan en un solo flujo. Acepta email, name, plan_id, y coupon_code opcional

review_dunning

Lista todas las facturas vencidas, clasifícalas como reintentar/detener/esperar, y actúa con confirmación

apply_discount

Valida y aplica un código promocional a una suscripción, mostrando primero el precio antes/después

Seguridad

  • Tokens con alcance limitado — 16 alcances agrupados en Lectura / Escritura / Sensible. Solo lectura por defecto, escritura opcional por categoría. La información de identificación personal (PII: correo, teléfono) tiene su propio alcance.

  • Puertas de confirmación — los reembolsos y las sesiones de pago grandes requieren confirmación explícita en la interfaz del host antes de ejecutarse.

  • Límite de gasto de 24 horas — límite estricto y continuo en reembolsos + sesiones de pago por token. Preconfigurado automáticamente a 50.000 rupias en tokens de escritura.

  • Límites de tasa por token — 60 llamadas/60s en total, 6 destructivas/60s, 2 con confirmación/60s.

  • Defensa contra inyección de prompts — campos controlados por el cliente envueltos como datos <untrusted>. Se eliminan los caracteres de ancho cero. Los secretos se redactan mediante patrones en la salida.

  • Auditoría completa — cada llamada a la herramienta se registra con el ID del token y el nombre del asistente, visible en /dashboard/mcp.

  • Código abierto — audita exactamente lo que se ejecuta con tu clave en github.com/paybridgenp/paybridgenp-mcp.

Configuración

Variable de entorno

Requerido

Por defecto

PAYBRIDGE_API_KEY

sí

—

PAYBRIDGE_API_BASE_URL

no

https://api.paybridgenp.com

También puedes pasar --api-key=sk_live_... como argumento de CLI.

Licencia

MIT — ver LICENSE.

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    A
    maintenance
    Enables AI agents to interact with Juspay's payment processing APIs and merchant dashboard for managing orders, transactions, refunds, customers, gateways, and reporting through natural language.
    21
    Apache 2.0
  • A
    license
    Not graded
    quality
    D
    maintenance
    Connects AI agents to Nepal's payment infrastructure through the PayArk API. It enables users to monitor transaction history, manage projects, and generate hosted checkout links using natural language.
    9 npm
    MIT
  • A
    license
    A
    quality
    C
    maintenance
    Enables AI assistants to interact with the full range of Paystack APIs, allowing operations like transaction management, customer creation, and payments through natural language.
    2
    41 npm
    55
    MIT