Setu KYC MCP server

A MCP server project for Setu KYC APIs that provides verification tools for PAN, GST, and name matching.

Components

Tools

The server implements three verification tools using Setu's Digital Gateway APIs:

1. verify-pan: Verify PAN card details

   • Required inputs:
     • pan: PAN card number
     • reason: Purpose of verification

2. verify-gst: Verify GST registration

   • Required input:
     • gstin: GST identification number

3. match-names: Compare two names for similarity

   • Required inputs:
     • name1: First name to compare
     • name2: Second name to compare
   • Returns both optimistic and pessimistic match results with percentages

Configuration

The server requires the following environment variables:

# Setu Digital Gateway Credentials
SETU_DG_CLIENT_ID=your-client-id
SETU_DG_CLIENT_SECRET=your-client-secret

# Product Instance IDs for different services
SETU_DG_PAN_PRODUCT_INSTANCE_ID=your-pan-instance-id
SETU_DG_GST_PRODUCT_INSTANCE_ID=your-gst-instance-id
SETU_DG_NAME_MATCH_PRODUCT_INSTANCE_ID=your-name-match-instance-id

Quickstart

Install

pip install setu_mcp_kyc

Claude Desktop Configuration

On MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json On Windows: %APPDATA%/Claude/claude_desktop_config.json

"mcpServers": {
  "setu_mcp_kyc": {
    "command": "uv",
    "args": [
      "--directory",
      "/path/to/setu_mcp_kyc",
      "run",
      "setu_mcp_kyc"
    ],
    "env": {
      "SETU_DG_CLIENT_ID": "your-client-id",
      "SETU_DG_CLIENT_SECRET": "your-client-secret",
      "SETU_DG_PAN_PRODUCT_INSTANCE_ID": "your-pan-instance-id",
      "SETU_DG_GST_PRODUCT_INSTANCE_ID": "your-gst-instance-id",
      "SETU_DG_NAME_MATCH_PRODUCT_INSTANCE_ID": "your-name-match-instance-id"
    }
  }
}

"mcpServers": {
  "setu_mcp_kyc": {
    "command": "uvx",
    "args": [
      "setu_mcp_kyc"
    ],
    "env": {
      "SETU_DG_CLIENT_ID": "your-client-id",
      "SETU_DG_CLIENT_SECRET": "your-client-secret",
      "SETU_DG_PAN_PRODUCT_INSTANCE_ID": "your-pan-instance-id",
      "SETU_DG_GST_PRODUCT_INSTANCE_ID": "your-gst-instance-id",
      "SETU_DG_NAME_MATCH_PRODUCT_INSTANCE_ID": "your-name-match-instance-id"
    }
  }
}

Development

Building and Publishing

1. Sync dependencies:

uv sync

1. Build package:

uv build

1. Publish to PyPI:

uv publish

Debugging

For debugging, use the MCP Inspector:

npx @modelcontextprotocol/inspector uv --directory /path/to/setu_mcp_kyc run setu_mcp_kyc

Upon launching, the Inspector will display a URL that you can access in your browser to begin debugging.