| Name | setu_mcp_kyc JSON |
| Version |
0.1.1
JSON |
| download |
| home_page | None |
| Summary | A MCP server for Setu KYC APIs providing PAN, GST, and name matching verification |
| upload_time | 2025-01-23 09:16:52 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.12 |
| license | None |
| keywords |
gst
mcp
pan
setu
setu_mcp_kyc
verification
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# 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:
```bash
# 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
```bash
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`
<details>
<summary>Development Configuration</summary>
```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"
}
}
}
```
</details>
<details>
<summary>Production Configuration</summary>
```json
"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"
}
}
}
```
</details>
## Development
### Building and Publishing
1. Sync dependencies:
```bash
uv sync
```
2. Build package:
```bash
uv build
```
3. Publish to PyPI:
```bash
uv publish
```
### Debugging
For debugging, use the MCP Inspector:
```bash
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.
Raw data
{
"_id": null,
"home_page": null,
"name": "setu_mcp_kyc",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.12",
"maintainer_email": null,
"keywords": "gst, mcp, pan, setu, setu_mcp_kyc, verification",
"author": null,
"author_email": "Kaustav Banerjee <kaustav@setu.co>",
"download_url": "https://files.pythonhosted.org/packages/ad/08/1ce26d7a36d0b1a8a8fa187f9627f4b200ad8d6dab8c93fcbc9393848a4a/setu_mcp_kyc-0.1.1.tar.gz",
"platform": null,
"description": "# Setu KYC MCP server\n\nA MCP server project for Setu KYC APIs that provides verification tools for PAN, GST, and name matching.\n\n## Components\n\n\n### Tools\n\nThe server implements three verification tools using Setu's Digital Gateway APIs:\n\n1. **verify-pan**: Verify PAN card details\n - Required inputs: \n - `pan`: PAN card number\n - `reason`: Purpose of verification\n\n2. **verify-gst**: Verify GST registration\n - Required input:\n - `gstin`: GST identification number\n\n3. **match-names**: Compare two names for similarity\n - Required inputs:\n - `name1`: First name to compare\n - `name2`: Second name to compare\n - Returns both optimistic and pessimistic match results with percentages\n\n## Configuration\n\nThe server requires the following environment variables:\n\n```bash\n# Setu Digital Gateway Credentials\nSETU_DG_CLIENT_ID=your-client-id\nSETU_DG_CLIENT_SECRET=your-client-secret\n\n# Product Instance IDs for different services\nSETU_DG_PAN_PRODUCT_INSTANCE_ID=your-pan-instance-id\nSETU_DG_GST_PRODUCT_INSTANCE_ID=your-gst-instance-id\nSETU_DG_NAME_MATCH_PRODUCT_INSTANCE_ID=your-name-match-instance-id\n```\n\n## Quickstart\n\n### Install\n\n```bash\npip install setu_mcp_kyc\n```\n\n#### Claude Desktop Configuration\n\nOn MacOS: `~/Library/Application\\ Support/Claude/claude_desktop_config.json`\nOn Windows: `%APPDATA%/Claude/claude_desktop_config.json`\n\n<details>\n <summary>Development Configuration</summary>\n \n ```json\n \"mcpServers\": {\n \"setu_mcp_kyc\": {\n \"command\": \"uv\",\n \"args\": [\n \"--directory\",\n \"/path/to/setu_mcp_kyc\",\n \"run\",\n \"setu_mcp_kyc\"\n ],\n \"env\": {\n \"SETU_DG_CLIENT_ID\": \"your-client-id\",\n \"SETU_DG_CLIENT_SECRET\": \"your-client-secret\",\n \"SETU_DG_PAN_PRODUCT_INSTANCE_ID\": \"your-pan-instance-id\",\n \"SETU_DG_GST_PRODUCT_INSTANCE_ID\": \"your-gst-instance-id\",\n \"SETU_DG_NAME_MATCH_PRODUCT_INSTANCE_ID\": \"your-name-match-instance-id\"\n }\n }\n }\n ```\n</details>\n\n<details>\n <summary>Production Configuration</summary>\n \n ```json\n \"mcpServers\": {\n \"setu_mcp_kyc\": {\n \"command\": \"uvx\",\n \"args\": [\n \"setu_mcp_kyc\"\n ],\n \"env\": {\n \"SETU_DG_CLIENT_ID\": \"your-client-id\",\n \"SETU_DG_CLIENT_SECRET\": \"your-client-secret\",\n \"SETU_DG_PAN_PRODUCT_INSTANCE_ID\": \"your-pan-instance-id\",\n \"SETU_DG_GST_PRODUCT_INSTANCE_ID\": \"your-gst-instance-id\",\n \"SETU_DG_NAME_MATCH_PRODUCT_INSTANCE_ID\": \"your-name-match-instance-id\"\n }\n }\n }\n ```\n</details>\n\n## Development\n\n### Building and Publishing\n\n1. Sync dependencies:\n```bash\nuv sync\n```\n\n2. Build package:\n```bash\nuv build\n```\n\n3. Publish to PyPI:\n```bash\nuv publish\n```\n\n### Debugging\n\nFor debugging, use the MCP Inspector:\n\n```bash\nnpx @modelcontextprotocol/inspector uv --directory /path/to/setu_mcp_kyc run setu_mcp_kyc\n```\n\nUpon launching, the Inspector will display a URL that you can access in your browser to begin debugging.",
"bugtrack_url": null,
"license": null,
"summary": "A MCP server for Setu KYC APIs providing PAN, GST, and name matching verification",
"version": "0.1.1",
"project_urls": {
"Documentation": "https://github.com/SetuHQ/setu-mcps/tree/main/setu_mcp_kyc",
"Homepage": "https://setu.co",
"Repository": "https://github.com/SetuHQ/setu-mcps/tree/main/setu_mcp_kyc"
},
"split_keywords": [
"gst",
" mcp",
" pan",
" setu",
" setu_mcp_kyc",
" verification"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "80796bd5d8eb4de1f1bd9dfc731d0ed422df6099c4a7c10b9eb15add5384d021",
"md5": "4869e7eb3c0d5b0b0f98d5b8cbbf9de4",
"sha256": "c59d93ea902b0f2dfca992011a8a716144c781e35d6c3e5c31dc5380a912ec51"
},
"downloads": -1,
"filename": "setu_mcp_kyc-0.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "4869e7eb3c0d5b0b0f98d5b8cbbf9de4",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.12",
"size": 4640,
"upload_time": "2025-01-23T09:16:50",
"upload_time_iso_8601": "2025-01-23T09:16:50.622820Z",
"url": "https://files.pythonhosted.org/packages/80/79/6bd5d8eb4de1f1bd9dfc731d0ed422df6099c4a7c10b9eb15add5384d021/setu_mcp_kyc-0.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "ad081ce26d7a36d0b1a8a8fa187f9627f4b200ad8d6dab8c93fcbc9393848a4a",
"md5": "c3dc9cbd485816e58f02858412d4b853",
"sha256": "a6985801446cb17799395eaca488e3ce6c6cbb4996c0cf15c1851db0fc8deba6"
},
"downloads": -1,
"filename": "setu_mcp_kyc-0.1.1.tar.gz",
"has_sig": false,
"md5_digest": "c3dc9cbd485816e58f02858412d4b853",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.12",
"size": 11267,
"upload_time": "2025-01-23T09:16:52",
"upload_time_iso_8601": "2025-01-23T09:16:52.900865Z",
"url": "https://files.pythonhosted.org/packages/ad/08/1ce26d7a36d0b1a8a8fa187f9627f4b200ad8d6dab8c93fcbc9393848a4a/setu_mcp_kyc-0.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-23 09:16:52",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "SetuHQ",
"github_project": "setu-mcps",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "setu_mcp_kyc"
}
