@payark/mcp-server

The official PayArk Model Context Protocol (MCP) server.

Connect PayArk to your AI agents (Claude, Cursor, Gemini, etc.) to manage transactions, list projects, and generate payment links using natural language.

🛠 Features

• Tool-based Interaction:
  • list_projects: View all PayArk projects in your account.
  • list_payments: Fetch recent transactions for any project.
  • get_payment: Check status and details of a specific payment.
  • create_payment_link: Generate hosted checkout URLs instantly.
• Dual Transport Support:
  • Stdio: For local use in desktop clients (Cursor, Claude Desktop).
  • SSE: Support for web-based agents and remote connections.
• Secure Auth: Uses PayArk Personal Access Tokens (PAT).

🚀 Quick Start (Local Setup)

1. Generate a PAT

Go to the PayArk Dashboard > Developers and generate a new Personal Access Token.

2. Configure Your AI Client

Cursor

1. Open Cursor Settings > MCP.
2. Click + Add New MCP Server.
3. Name: PayArk
4. Type: command
5. Command:

   export PAYARK_PAT=pat_your_token_here && npx -y @payark/mcp-server

Claude Desktop

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "payark": {
      "command": "bun",
      "args": ["run", "https://raw.githubusercontent.com/Payark-Inc/payark/main/packages/mcp-server/src/index.ts"],
      "env": {
        "PAYARK_PAT": "pat_your_token_here"
      }
    }
  }
}

🌐 Remote / SSE Mode

To run a persistent MCP server via SSE (for custom integrations):

export PAYARK_PAT=pat_...
export PORT=3001
bun run src/index.ts --sse

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

📚 API Reference (Tools)

create_payment_link

Generates a hosted payment URL.

• amount: (number) NPR amount.
• provider: (esewa | khalti).
• returnUrl: (string) Success redirect.

list_payments

• projectId: (uuid) The project to query.
• limit: (number) Defaults to 10.

🛠 Development

# Install
bun install

# Run in dev mode (watch)
PAYARK_PAT=pat_... bun run dev

# Build
bun run build

📄 License

MIT © 2026 PayArk Labs.