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 (a fast Python package installer and runner)
• Claude Desktop (for running and managing the server)

Installation

Option 1: Automated Setup (Recommended)

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

# 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:

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

2. Create and activate a virtual environment:

   uv venv
   source .venv/bin/activate
   

3. Install dependencies:

   uv pip install .
   

Configuration

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

   # 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:

{
  "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 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.