Paytm

You run a Python-based MCP server to manage Paytm payment links and their transactions. This server lets you create payment links for customers, view all created links, and fetch the transactions tied to a specific link, all from a centralized control plane you manage through Claude Desktop.

How to use

You interact with the Paytm MCP Server through an MCP client configured to connect via the provided MCP entry. With this server you can create Paytm payment links for customers, fetch all existing payment links, and retrieve the transactions associated with a chosen link. The server is designed to be managed via Claude Desktop, so you’ll typically run and monitor it through that interface rather than starting it directly from the command line.

How to install

Prerequisites you must have before installing the Paytm MCP Server:

• Python 3.12 or higher
• Paytm credentials: PAYTM_MID and PAYTM_KEY_SECRET
• Python dependencies: httpx>=0.28.1, mcp[cli]>=1.7.0, paytmchecksum, pycryptodome, requests
• uv (the Python package installer and runner)
• Claude Desktop for running and managing the server

Option 1 — Automated setup (recommended)

# Make the script executable
chmod +x setup.sh

# Run the setup script
./setup.sh

What the automated script does for you: it checks for prerequisites (Python 3.12+, uv, Claude Desktop), clones or updates the project, creates and activates a virtual environment, installs dependencies, and creates a .env template for Paytm credentials.

Option 2 — Manual installation

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 .

Create a .env file in the project root with your Paytm credentials as shown below.

# Paytm credentials
PAYTM_MID=your_paytm_mid
PAYTM_KEY_SECRET=your_paytm_key_secret

Additional configuration and runtime notes

Configuration is stored in a .env file at the project root. You should populate PAYTM_MID and PAYTM_KEY_SECRET with your actual Paytm credentials.

Managing the server with Claude Desktop is the intended workflow. The sample configuration shown below demonstrates how Claude Desktop can run the MCP server using uv and a Python entry point.

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

Configuration and environment variables

The server relies on environment variables for Paytm credentials. Ensure the following variables are present in your runtime environment within Claude Desktop and in any local development setup you use.

PAYTM_MID=your_paytm_mid
PAYTM_KEY_SECRET=your_paytm_key_secret

Project structure

Key components of the Paytm MCP Server project include the main entry point and tool definitions, business logic for payments, configuration and settings, and utilities for data models.

Next steps

1. Update the Claude Desktop configuration with your Paytm credentials. 2. Restart or start the server through Claude Desktop to begin managing Paytm payment links and transactions.

Security and troubleshooting notes

Keep Paytm credentials secure. Do not expose PAYTM_MID or PAYTM_KEY_SECRET in public configurations. If you encounter issues starting the server, verify that Claude Desktop is correctly configured to run the MCP entry point and that the environment variables are correctly loaded.

Examples and notes

Typical usage includes creating payment links for customers, listing all existing links, and retrieving transactions for a given link. Your MCP client should be configured to communicate with the Paytm MCP Server via the MCP entry you defined in Claude Desktop.

Available tools

create_link

Create a Paytm payment link for a customer and obtain the link details.

list_links

Fetch all Paytm payment links that have been created.

get_transactions

Retrieve transactions associated with a specific Paytm payment link.