@payark/mcp-server

<p align="center"> <img src="https://raw.githubusercontent.com/Payark-Inc/payark/main/apps/public-demo/public/og-image.png" alt="PayArk MCP Server" width="100%" /> </p>

<p align="center"> <strong>Connect your AI agent to Nepal's payment infrastructure — in minutes.</strong> </p>

---

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

1. Go to your PayArk Dashboard → Developers.
2. Generate a Personal Access Token (PAT).
3. 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)

1. Open Cursor Settings → MCP.
2. Click + Add New MCP Server.
3. 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."

---

License

MIT © 2026 PayArk Labs.