Incode-IDV-MCP: MCP Tool for AI Assistant Authentication with Link Generation

Incode Idv MCP

The Incode identity verification MCP server provides authentication capabilities for AI assistants, including generating verification links, checking session statuses, obtaining verification scores, and managing authentication tokens.

Security Finance #Identity verification #AI integration #Security authentication #MCP service .TypeScript

rating : 2 points

downloads : 7.7K

update time : 2025-12-29

Open Site

What is the Incode IDV MCP Server?

This is an authentication integration tool specifically designed for AI assistants. It allows AI assistants like Claude to directly interact with Incode's authentication system without users having to manually operate complex verification processes. Through simple natural language instructions, the AI can assist you in completing all aspects of authentication.

How to use the Incode IDV MCP Server?

It's very easy to use: First, obtain an API key. Then, configure the server in Claude Desktop. Finally, interact with the AI through natural language. The AI will understand your needs and call the corresponding verification functions.

Applicable scenarios

Suitable for various scenarios that require online identity verification: user registration verification, identity confirmation for financial transactions, permission verification for sensitive operations, compliance checks, etc. Particularly suitable for applications and services that require fast and secure user identity verification.

Main features

Generate verification link

Create a new identity verification session and generate a dedicated verification URL for users to access.

Status monitoring

Check the progress and status of the verification session in real - time to understand which step the verification has reached.

Score acquisition

After the verification is completed, obtain detailed verification results and scores to understand the credibility of the verification.

Token management

Obtain and verify JWT tokens for subsequent identity verification and authorization operations.

Natural language interaction

Complete all verification operations through simple dialogue instructions without the need for technical knowledge.

Advantages

Seamless integration: Directly integrated with AI assistants without the need for an additional interface.

Easy to operate: Complete complex verifications through natural language instructions.

Comprehensive functions: Covers the entire identity verification process, from link generation to result acquisition.

Secure and reliable: Based on Incode's mature identity verification technology.

Quick deployment: Simple configuration and can be used within minutes.

Limitations

Requires an API key: Must register an Incode account to obtain the key.

Depends on the network: Requires a stable network connection.

Token validity period: JWT tokens are only valid for 15 minutes.

Claude - specific: Currently mainly optimized for Claude Desktop.

How to use

Obtain an API key

Visit the Incode MCP Playground website to register an account and obtain an API key.

Configure Claude Desktop

Add MCP server settings to the Claude Desktop configuration file.

Add server configuration

Add the configuration information of the Incode IDV MCP server to the configuration file.

Restart and verify

Restart the Claude Desktop application and then test whether the function is working properly through dialogue.

Usage examples

New user registration verification

When a new user registers for your service, their identity authenticity needs to be verified.

Transaction identity confirmation

Before conducting large - scale financial transactions, the user's identity needs to be confirmed.

Periodic compliance checks

Re - verify user identities periodically as required by regulations.

Frequently Asked Questions

Do I need to pay to use this service?

How long does the verification process take?

What should I do after the token expires?

What types of identity verification are supported?

What should I do if I encounter configuration issues?

Related resources

Incode official website

The official website of Incode Technologies. Learn more about identity verification solutions.

MCP Playground

A platform to obtain API keys and test functions.

GitHub repository

Source code and detailed technical documentation.

npm package

An npm package for direct installation.

Technical support email

Get technical support and answer questions.

🚀 Incode IDV MCP Server

An MCP server that seamlessly integrates Incode's identity verification into AI assistants like Claude, enabling natural - language - based verification workflows.

🚀 Quick Start

Get Your API Key 🔑

Visit https://mcp-playground.labs.incode.com/
Sign up for an account
Verify your email and retrieve your API KEY

Install & Configure

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "incode-idv": {
      "command": "npx",
      "args": ["-y", "@incodetech/incode-idv-mcp"],
      "env": {
        "API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

💡 Usage Tip

Replace YOUR_API_KEY_HERE with your actual API key from step 1

Configure Claude Desktop

Open Claude Desktop App
Navigate to Settings
Go to Developer tab
Click Edit Config
Add the configuration above with your API_KEY
Restart Claude Desktop to load the new MCP server. Ensure MCP server is enabled.

Verify Installation

After restarting Claude Desktop, ask Claude:

"Can you generate an identity verification link?" If configured correctly, Claude will use the MCP server to create a verification session!

✨ Features

An MCP (Model Context Protocol) server that integrates Incode's identity verification into AI assistants like Claude. Enable your AI to generate verification links, check session status, retrieve scores, and manage authentication tokens — all through natural language.

📦 Installation

Install & Configure

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "incode-idv": {
      "command": "npx",
      "args": ["-y", "@incodetech/incode-idv-mcp"],
      "env": {
        "API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

💡 Usage Tip

Replace YOUR_API_KEY_HERE with your actual API key from step 1

Configure Claude Desktop

Open Claude Desktop App
Navigate to Settings
Go to Developer tab
Click Edit Config
Add the configuration above with your API_KEY
Restart Claude Desktop to load the new MCP server. Ensure MCP server is enabled.

💻 Usage Examples

After restarting Claude Desktop, ask Claude:

"Can you generate an identity verification link?"

If configured correctly, Claude will use the MCP server to create a verification session!

📚 Documentation

Available Tools

The server provides five powerful tools for complete identity verification workflows:

Property	Details
generate_interview_link	Create a new verification session. Inputs: None (backend configured). Returns: Interview ID & URL
get_interview_status	Check session progress. Inputs: `interviewId`. Returns: Status & progress info
get_interview_score	Get verification results. Inputs: `interviewId`. Returns: Score & detailed results
get_interview_token	Get JWT token on successful interview (15 min TTL). Inputs: `interviewId`. Returns: JWT access token
validate_token	Verify token validity. Inputs: `token`. Returns: Validation result & claims

View Detailed Tool Specifications

generate_interview_link

Create a new identity verification session.

Inputs: None (all values are configured on the backend)
Returns: Interview ID and verification URL

get_interview_status

Check the current status of an identity verification session.

Inputs:
- interviewId (string): The interview ID returned from generate_interview_link
Returns: Current status and progress information

get_interview_score

Retrieve verification results and score for a completed session.

Inputs:
- interviewId (string): The interview ID returned from generate_interview_link
Returns: Verification result, score, and detailed information

get_interview_token

Get JWT token directly for successfully completed interviews (15 - minute TTL).

Inputs:
- interviewId (string): The interview ID returned from generate_interview_link
Returns: JWT access token and metadata

validate_token

Validate JWT token and return claims.

Inputs:
- token (string): JWT token to validate
Returns: Validation result and token claims if valid

Verification Workflow

The typical identity verification workflow is straightforward and powerful:

graph LR
    A[Generate Link] --> B[Check Status]
    B --> C[Get Score]
    C --> D[Get JWT Token]
    D --> E[Validate Token]
    style B stroke-dasharray: 5 5
    style C stroke-dasharray: 5 5

Step-by-Step Process

Step	Action	Tool	Purpose
1	Generate Link	`generate_interview_link`	Create verification URL for user
2	Check Status	`get_interview_status`	Monitor completion progress
3	Get Score	`get_interview_score`	Retrieve verification results
4	Get Interview JWT Token	`get_interview_token`	Obtain JWT token when succesful interview with results (15 min TTL)
5	Validate Token	`validate_token`	Verify JWT token is from valid interview

🔧 Technical Details

Troubleshooting

Having issues? Here's how to get back on track:

Common Issues

Issue	Solution
Tools Not Working	Verify your `API_KEY` is correctly set in the configuration with a valid value
Path Errors	Ensure the project directory path or package name is correct.
Server Not Starting	Validate your `claude_desktop_config.json` syntax (no trailing commas, proper quotes)
Token Expired	JWT tokens expire in 15 min. Generate new ones as needed