How do I use PayBridgeNP MCP Server?

1. Click on "Install 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.

@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.

69 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": {
        "PAYBRIDGE_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 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_..." }
    }
  }
}

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

Tools (69)

Read (31)

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`
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 (38)

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_trial`, `extend_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 — 60 calls/60s overall, 6 destructive/60s, 2 elicitation-gated/60s.
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
`PAYBRIDGE_API_KEY`	yes	—
`PAYBRIDGE_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 installed

A

license - permissive license

-

quality - not tested

C

maintenance

How are these scores calculated?

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

PayBridgeNP MCP Server