Reviewed overview
MCP server overview
what is Kyc?
Kyc is an MCP (Model Context Protocol) server project that wraps Setu Digital Gateway KYC APIs to provide verification tools for PAN, GST and name-matching. It’s a packaged MCP server intended to be run as part of a Claude/ModelContext setup or as a standalone MCP process.
how to use Kyc?
- Install: pip install setu_mcp_kyc
- Provide Setu DG credentials and product instance IDs via environment variables: SETU_DG_CLIENT_ID, SETU_DG_CLIENT_SECRET, SETU_DG_PAN_PRODUCT_INSTANCE_ID, SETU_DG_GST_PRODUCT_INSTANCE_ID, SETU_DG_NAME_MATCH_PRODUCT_INSTANCE_ID.
- Development run: configure your Claude/claude_desktop_config.json or run the MCP with the provided “uv” command (see project dev config). Production run uses “uvx”.
- Debug with MCP Inspector: npx @modelcontextprotocol/inspector uv --directory /path/to/setu_mcp_kyc run setu_mcp_kyc
key features
- verify-pan: PAN card verification (inputs: pan, reason)
- verify-gst: GST registration verification (input: gstin)
- match-names: name similarity check, returns optimistic and pessimistic match percentages
- Packaged as an MCP server and published to PyPI for easy install and integration
- Developer tooling: build/publish workflow (uv sync, uv build, uv publish) and Inspector debugging
use cases
- Customer onboarding and identity verification
- Compliance and KYC checks for financial services
- Payment/merchant onboarding requiring PAN/GST validation
- Automated name-matching for record reconciliation and fraud detection
- Integrating Setu KYC capabilities into chat/assistant workflows via MCP
FAQ
- What inputs are required?
- PAN verification: pan, reason. GST: gstin. Name match: name1, name2.
- How do I get credentials/product instance IDs?
- Obtain Setu Digital Gateway client ID/secret and product instance IDs from Setu (your Setu account/portal).
- Can I run this locally?
- Yes. Set env vars and run using the development MCP config (“uv” command) or configure Claude Desktop to point to the server folder.
- Is this distributed as a package?
- Yes: pip install setu_mcp_kyc. Build and publish via uv build / uv publish.
- How do I debug?
- Use the MCP Inspector command shown in the README to launch a debugging UI.
- Is it production-ready?
- The repo provides production run hints (uvx) and env-based config; ensure secure storage of credentials and follow Setu’s production onboarding steps.