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:

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

Quick Start

Get Your API Key 🔑

1. Visit https://mcp-playground.labs.incode.com/
2. Sign up for an account
3. 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"
      }
    }
  }
}

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

Configure Claude Desktop

1. Open Claude Desktop App
2. Navigate to Settings
3. Go to Developer tab
4. Click Edit Config
5. Add the configuration above with your API_KEY
6. 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!

🔧 Troubleshooting

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

Common Issues

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

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