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

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

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 aisupport@incode.com 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.