# eSewa & Khalti MCP Servers

[![npm version](https://img.shields.io/npm/v/esewa-mcp.svg)](https://www.npmjs.com/package/esewa-mcp)
[![npm version](https://img.shields.io/npm/v/khalti-mcp.svg)](https://www.npmjs.com/package/khalti-mcp)
[![npm downloads](https://img.shields.io/npm/dt/esewa-mcp.svg)](https://www.npmjs.com/package/esewa-mcp)
[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)

Nepal's first MCP servers for eSewa and Khalti — the two dominant payment gateways in Nepal (eSewa alone
serves 15M+ users). This monorepo lets Claude initiate and manage payments directly in conversation, with
HMAC-SHA256 request signing so credentials never leave your own environment.

<img width="1316" height="1174" alt="image" src="https://github.com/user-attachments/assets/342acc64-8a69-49cb-988c-16bccaca320f" />

## What is MCP?

The Model Context Protocol (MCP) is an open standard that enables Claude and other AI models to safely
interact with tools, APIs, and data sources. MCP servers allow you to extend Claude's capabilities by
exposing custom functionality through a standardized interface.

## What's Included

This monorepo contains two MCP servers for Nepali payment gateways:

- **[Khalti MCP Server](./packages/khalti-mcp)** — Integrate Khalti payment gateway with Claude
- **[eSewa MCP Server](./packages/esewa-mcp)** — Integrate eSewa payment gateway with Claude, with
  HMAC-SHA256 signed requests

## Quick Start

### Using with Claude Desktop

1. Install all packages:
   ```bash
   npm install
   npm run build
   ```
2. Configure in `~/.config/Claude/claude_desktop_config.json`:
   ```json
   {
     "mcpServers": {
       "khalti-mcp": {
         "command": "npx",
         "args": ["-y", "khalti-mcp"],
         "env": {
           "KHALTI_SECRET_KEY": "your-khalti-secret-key",
           "KHALTI_GATEWAY_URL": "https://a.khalti.com/api/v2"
         }
       },
       "esewa-mcp": {
         "command": "npx",
         "args": ["-y", "esewa-mcp"],
         "env": {
           "ESEWA_SECRET_KEY": "your-esewa-secret-key",
           "ESEWA_PRODUCT_CODE": "your-esewa-product-code",
           "ESEWA_GATEWAY_URL": "https://uat.esewa.com.np/api/epay/main/v2/form"
         }
       }
     }
   }
   ```
3. Restart Claude Desktop and start using payment tools in conversations.

### Using with Claude Code

```bash
claude mcp add khalti-mcp -- npx -y khalti-mcp
claude mcp add esewa-mcp -- npx -y esewa-mcp
```

## Development

```bash
# Install dependencies
npm install

# Build all packages
npm run build

# Development mode (watch)
npm run dev
```

## Packages

See individual package READMEs for detailed documentation:

- [Khalti MCP](./packages/khalti-mcp/README.md)
- [eSewa MCP](./packages/esewa-mcp/README.md)

## License

MIT