MCP

The Intellicheck Direct Developer Hub Model Context Protocol (MCP) server enables AI-powered code editors like Cursor and Windsurf, plus general-purpose tools like Claude Desktop, to interact directly with your Intellicheck Direct Developer Hub API and documentation.

What is MCP?

Model Context Protocol (MCP) is an open standard that allows AI applications to securely access external data sources and tools. The Intellicheck Direct Developer Hub MCP server provides AI agents with:

  • Access to the IDN-Direct API specification for the AI agent to read details like request properties, response properties, and complete schemas for every object.
  • Code generation assistance for Intellicheck Direct Developer Hub integrations.

Intellicheck Direct Developer Hub MCP Server Setup

Intellicheck Direct Developer Hub hosts a remote MCP server at https://idn-direct-api.readme.io/mcp. Configure your AI development tools to connect to this server. Because this is a simulated API, no authentication is required. You can pass in headers via query parameters or however headers are configured in your MCP client.

Add to~/.cursor/mcp.json:

{
  "mcpServers": {
    "idn-direct-api": {
      "url": "https://idn-direct-api.readme.io/mcp"
    }
  }
}

Testing Your MCP Setup

Once configured, you can test your MCP server connection:

  1. Open your AI editor (Cursor, Windsurf, Claude Desktop).
  2. Start a new chat with the AI assistant.
  3. Ask about Intellicheck Direct Developer Hub
  4. Try questions like:
    • "How do I run a barcode check?"
    • "Show me example results from a front side and back side check."
    • "Create a valid /start request."

The AI has access to the OpenAPI specification through the MCP server. Here is a list of common commands:

  • execute-request - Make API calls directly from your specification
  • get-endpoint - Pull in detailed endpoint information on demand
  • get-request-body - Access structured request parameters
  • get-response-schema - Understand what your API returns
  • list-endpoints - Browse all available API endpoints
  • search-schema - Find exactly what you need in your API spec
  • get-code-snippet - Example code snippets in your preferred language to interact with your endpoint.
👍

Remember that MCP commands like execute-request use our API simulator. Simulated results are pretty accurate. But discrepancies are still possible. Feel free to use the MCP server for exploring and learning. However, we humbly ask that you do not write production code against simulated results. 🙏 Save that for your staging environment. Learn more here: Sandbox and Staging.