@incodetech/incode-idv-mcp

Incode IDV MCP Server

Powered by Incode Technologies — Global Leader in Identity Verification

Brand notice: The Incode name and logo are trademarks of Incode.
© Incode. All rights reserved. Not covered by this project's open-source license.

About

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.

🛠️ Available Tools

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

Tool	Description	Key Parameters	Returns
generate_interview_link	Create a new verification session	None (backend configured)	Interview ID & URL
get_interview_status	Check session progress	interviewId	Status & progress info
get_interview_score	Get verification results	interviewId	Score & detailed results
get_interview_token	Get JWT token on successful interview (15 min TTL)	interviewId	JWT access token
validate_token	Verify token validity	token	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

🚀 Quick Start

1️⃣ Get Your API Key - 🔑

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

2️⃣ 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"
      }
    }
  }
}

💡 Tip: Replace YOUR_API_KEY_HERE with your actual API key from step 1

3️⃣ 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.

4️⃣ 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! 🎉

🔧 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

🔍 Debugging Tools

For advanced debugging and troubleshooting:

• 📋 View Claude Desktop Logs — Check detailed error messages
• 📚 MCP Debugging Guide — Comprehensive troubleshooting steps
• 🔧 Test API Key — Try the API key directly on mcp-playground.labs.incode.com

💬 Get Help

🐛	GitHub Issues Report bugs & request features
📧	Email Support [e-mail] for issues and inquiries
🌐	Incode Website incode.com for company information

📄 License

This project is licensed under the MIT License — free to use, modify, and distribute.

See the LICENSE file for full details.

Developed by Incode Technologies

Website • Documentation • GitHub • npm • Other Docs

Transforming identity verification with AI-powered solutions