@payark/mcp-server

PayArk MCP Server

Connect your AI agent to Nepal's payment infrastructure — in minutes.

What is this?

The PayArk MCP Server is a Model Context Protocol integration that gives AI agents like Claude, Cursor, and Gemini direct access to your PayArk account. Instead of switching between dashboards or writing boilerplate API calls, you can ask your AI in plain language:

"How many payments did we process through Khalti in the last 24 hours?" "Generate a checkout link for Rs. 500." "Why did payment pay_abc123 fail?"

Available Tools

Tool	What it does
`list_projects`	Lists all your PayArk projects and their IDs
`list_payments`	Fetches transaction history with optional filters
`get_payment`	Gets the full state of a single payment
`create_payment_link`	Generates a hosted checkout URL

Quick Start

Step 1 — Get your credentials

Go to your PayArk Dashboard → Developers.
Generate a Personal Access Token (PAT).
Keep it secret — it grants account-level access.

Step 2 — Connect your agent

Claude Desktop

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "payark": {
      "command": "npx",
      "args": ["-y", "@payark/mcp-server"],
      "env": {
        "PAYARK_PAT": "pat_your_token_here",
        "PAYARK_API_URL": "https://api.payark.com"
      }
    }
  }
}

Cursor (Desktop IDE)

Open Cursor Settings → MCP.
Click + Add New MCP Server.
Set the name to PayArk, type to command, and use this command:

export PAYARK_PAT=pat_... && npx @payark/mcp-server

Remote / SSE Mode

For web-based agents or cloud-to-cloud connections, run the server in SSE mode:

export PAYARK_PAT=pat_...
export PORT=3001
bun run @payark/mcp-server --sse

The SSE endpoint will be available at http://localhost:3001/sse.

Security

Authentication is handled via Personal Access Tokens (PATs), which are scoped to your user account rather than any single project. This means:

Full audit trail — every MCP-triggered action appears in your account's audit log.
Easy revocation — if a token is compromised, revoke it instantly from the dashboard.
Encrypted in transit — all communication with the PayArk API uses TLS 1.3.

Prompting Tips

To get better results from your agent, give it context upfront:

"You are a FinTech assistant with access to PayArk MCP tools. Help me monitor transactions and generate payment links. When I ask for a payment link, suggest the best provider based on recent success rates."