# Paytm MCP Server

A Python-based MCP (Merchant Control Panel) server for managing Paytm payment links and transactions.

## Features

- Create Paytm payment links for customers
- Fetch all created payment links
- Retrieve transactions for a specific payment link

## Prerequisites

- Python 3.12 or higher
- Paytm Merchant credentials:
  - `PAYTM_MID`
  - `PAYTM_KEY_SECRET`
- The following Python dependencies:
  - httpx>=0.28.1
  - mcp[cli]>=1.7.0
  - paytmchecksum
  - pycryptodome
  - requests
- [uv](https://github.com/astral-sh/uv) (a fast Python package installer and runner)
- [Claude Desktop](https://www.anthropic.com/claude) (for running and managing the server)

## Installation

### Option 1: Automated Setup (Recommended)

Use the provided `setup.sh` script for automated installation and configuration:

```bash
# Make the script executable
chmod +x setup.sh

# Run the setup script
./setup.sh
```

The script will:

1. Check for required dependencies (Python 3.12+, uv, Claude Desktop)
2. Clone or update the repository
3. Create and activate a virtual environment
4. Install all required dependencies
5. Create a `.env` file template for Paytm credentials

### Option 2: Manual Installation

1. **Clone the repository:**

   ```bash
   git clone git@bitbucket.org:paytmteam/payment-mcp.git
   cd payment-mcp
   ```

2. **Create and activate a virtual environment:**

   ```bash
   uv venv
   source .venv/bin/activate
   ```

3. **Install dependencies:**
   ```bash
   uv pip install .
   ```

## Configuration

1. **Create a `.env` file in the project root:**

   ```bash
   # Paytm credentials
   PAYTM_MID=your_paytm_mid
   PAYTM_KEY_SECRET=your_paytm_key_secret
   ```

2. **Update the `.env` file with your actual Paytm credentials**

## Running the MCP Server with Claude Desktop

The server is designed to be managed and run via Claude Desktop. You do not need to run the server manually from the command line.

### Sample `claude_desktop_config.json`

Place this file in your project root or as required by Claude Desktop:

```json
{
  "mcpServers": {
    "paytm-mcp-server": {
      "command": "uv path",
      "args": ["--directory", "path to project", "run", "paytm_mcp.py"],
      "env": {
        "PAYTM_MID": "****************",
        "PAYTM_KEY_SECRET": "************"
      }
    }
  }
}
```

- Update the `command` and `args` paths as needed for your environment.
- The `env` section should contain your actual Paytm credentials.

## Next Steps

1. Update the `claude_desktop_config.json` with your Paytm credentials
2. Restart the server using Claude Desktop

## Project Structure

- `paytm_mcp.py`: Main server entry point and tool definitions
- `services/`: Business logic for payments
- `config/`: Configuration and settings
- `utils/`: Data models and utilities

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

The MIT License is a permissive license that allows you to:

- Use the code commercially
- Modify the code
- Distribute the code
- Use the code privately
- Sublicense the code

The only requirement is that the license and copyright notice must be included in all copies or substantial portions of the software.