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_MIDPAYTM_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:
- Check for required dependencies (Python 3.12+, uv, Claude Desktop)
- Clone or update the repository
- Create and activate a virtual environment
- Install all required dependencies
- Create a
.envfile template for Paytm credentials
Option 2: Manual Installation
-
Clone the repository:
git clone git@bitbucket.org:paytmteam/payment-mcp.git cd payment-mcp -
Create and activate a virtual environment:
uv venv source .venv/bin/activate -
Install dependencies:
uv pip install .
Configuration
-
Create a
.envfile in the project root:# Paytm credentials PAYTM_MID=your_paytm_mid PAYTM_KEY_SECRET=your_paytm_key_secret -
Update the
.envfile 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
commandandargspaths as needed for your environment. - The
envsection should contain your actual Paytm credentials.
Next Steps
- Update the
claude_desktop_config.jsonwith your Paytm credentials - Restart the server using Claude Desktop
Project Structure
paytm_mcp.py: Main server entry point and tool definitionsservices/: Business logic for paymentsconfig/: Configuration and settingsutils/: 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.