How do I use PayBridgeNP MCP Server?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@PayBridgeNP MCP Server show me yesterday's payment analytics" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

de en es ja ko ru zh

PayBridgeNP MCP Server

by paybridgenp

Overview Schema Source Related Servers Discussions Admin

TypeScript

Remote

@paybridge-np/mcp

Official Model Context Protocol server for PayBridgeNP, the Nepali payment gateway.

Lets Claude, ChatGPT, Cursor, Claude Code, VS Code - any MCP-compatible AI assistant - read and act on your PayBridgeNP account through natural language. Issue refunds, create payment links, manage subscriptions, inspect failed webhooks, pull KPIs - all by chatting.

70 tools. 6 built-in prompt templates. Scoped tokens. Spend caps. Full audit trail.

Install

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

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

Restart Claude Desktop.

Cursor

Same JSON in .cursor/mcp.json or via Settings → MCP.

Claude Code

claude mcp add paybridge \
  --env PAYBRIDGENP_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": { "PAYBRIDGENP_API_KEY": "sk_live_..." }
    }
  }
}

Generate a scoped MCP token from your PayBridgeNP dashboard. Don't paste a full-access REST key.

Related MCP server: PayArk MCP Server

Tools (69)

Read (32)

Category	Tools
Account	`get_account`
Payments	`list_payments`, `get_payment`
Refunds	`list_refunds`, `get_refund`
Sessions	`list_checkout_sessions`, `get_checkout_session`
Payment Links	`list_payment_links`, `get_payment_link`
Webhooks	`list_webhook_endpoints`, `list_webhook_deliveries`
Plans	`list_plans`, `get_plan`
Customers	`list_customers`, `get_customer`
Subscriptions	`list_subscriptions`, `get_subscription`
Invoices	`list_invoices`, `get_invoice`, `list_invoice_items`
Coupons	`list_coupons`, `get_coupon`
Promotions	`list_promotion_codes`, `get_promotion_code`, `validate_promotion_code`
Tax	`get_tax_settings`
Dunning	`list_dunning_policies`, `get_dunning_invoice_status`
Usage	`preview_subscription_proration`, `get_subscription_usage_summary`, `list_usage_records`
Analytics	`get_analytics_overview`

Write (37)

Money-moving tools (create_refund, cancel_subscription, delete_*) require explicit confirmation in the host UI before executing.

Category	Tools
Payments	`create_checkout_session`
Refunds	`create_refund`
Payment Links	`create_payment_link`, `update_payment_link`, `cancel_payment_link`, `delete_payment_link`
Webhooks	`create_webhook_endpoint`, `update_webhook_endpoint`, `delete_webhook_endpoint`
Plans	`create_plan`, `update_plan`
Customers	`create_customer`, `update_customer`, `add_customer_credit`
Subscriptions	`create_subscription`, `pause_subscription`, `resume_subscription`, `cancel_subscription`, `change_subscription_plan`, `end_subscription_trial`, `extend_subscription_trial`
Invoices	`create_invoice_item`, `delete_invoice_item`
Coupons	`create_coupon`, `deactivate_coupon`
Promotions	`create_promotion_code`, `deactivate_promotion_code`, `apply_coupon_to_subscription`, `remove_subscription_discount`
Tax	`update_tax_settings`
Dunning	`create_dunning_policy`, `update_dunning_policy`, `set_subscription_dunning_policy`, `stop_invoice_dunning`, `retry_invoice_dunning_now`
Usage	`report_subscription_usage`, `update_subscription_quantity`

Prompts

6 built-in prompt templates - appear as slash commands in Claude Desktop and Cursor (/ → type paybridge):

Prompt	What it does
`daily_summary`	End-of-day digest: revenue, payments, refunds, checkout funnel, webhook failures
`monthly_reconciliation`	Full month reconciliation table ready to share with your accountant. Takes optional `month` arg (e.g. `2026-04`)
`investigate_failed_payment`	Diagnose why payments failed - takes optional `payment_id` or `customer_email`
`onboard_customer`	Create a customer + subscribe to a plan in one flow. Takes `email`, `name`, `plan_id`, optional `coupon_code`
`review_dunning`	List all past-due invoices, categorize as retry/stop/wait, act with confirmation
`apply_discount`	Validate and apply a promo code to a subscription, showing before/after price first

Security

Scoped tokens - 16 scopes grouped Read / Write / Sensitive. Read-only by default, writes opt-in per category. PII (email, phone) is its own scope.
Elicitation gates - refunds and large checkout sessions require explicit confirmation in the host UI before executing.
24-hour spend cap - hard rolling cap on refunds + checkout sessions per token. Auto-prefilled to Rs 50,000 on write tokens.
Per-token rate limits - on the payment routes: 60 calls/60s overall, 6 destructive/60s, 2 elicitation-gated/60s. Billing routes use the project-level limit (120/min).
Prompt-injection defense - customer-controlled fields wrapped as <untrusted> data. Zero-width characters stripped. Secrets pattern-redacted on output.
Full audit trail - every tool call recorded with token id and assistant name, visible in /dashboard/mcp.
Open source - audit exactly what runs against your key at github.com/paybridgenp/paybridgenp-mcp.

Configuration

Env var	Required	Default
`PAYBRIDGENP_API_KEY`	yes	—
`PAYBRIDGENP_API_BASE_URL`	no	`https://api.paybridgenp.com`

You can also pass --api-key=sk_live_... as a CLI argument.

License

MIT - see LICENSE.

This server cannot be deployed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Maintenance

ActivityActive

ResponsivenessNo issues

Resources

Need Help?

Related Servers

Related MCP Connectors

BankSyncOAuth
io.banksync
Connect AI agents to bank accounts, transactions, balances, and investments.
Finance Customer Data Platforms App Automation
22
Era ContextOAuth
app.era
Personal finance, bank account, and shared memory connector for Claude, ChatGPT, Gemini Spark & more
Finance Knowledge & Memory
1
BankBridgeOAuth
money.bankbridge
Read-only bank access for your AI agent. Connects Claude, ChatGPT, Cursor, Gemini, Codex.
Finance Databases
2
griffnodeOAuth
com.griffnode
Non-custodial crypto payments for AI assistants: balances, payments, and create payment links.
Cryptocurrency Payments & Billing
2

Related MCP Servers

Juspay MCP Toolsofficial
Finance E-commerce & Retail App Automation
juspay
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.
Updated 2 days ago (2026-09-10 12:09 UTC)
21
Apache 2.0
PayArk MCP Server
Finance App Automation
Payark-Inc
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.
Updated 6 months ago (2026-03-14 05:44 UTC)
5
MIT
paystack-mcp-serverofficial
Payments & Billing Finance
PaystackOSS
A
license
A
quality
B
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.
Updated 2 months ago (2026-06-29 01:35 UTC)
2
38
54
MIT
paystack-mcp
Payments & Billing E-commerce & Retail
kohasummons
A
license
B
quality
C
maintenance
Enables AI agents to manage Paystack payments, products, customers, and transactions through natural language.
Updated a year ago (2025-04-28 10:00 UTC)
28
12
9
MIT