Model Context Protocol

MCP Server

Connect any AI assistant to GenuProof's full platform. Register brands, verify products, track supply chains, monitor threats, and export EU DPP compliance data — all through natural language.

Tools44
Categories8
Transportstdio
ProtocolJSON-RPC 2.0

Quick Start

1

Clone the repository

git clone https://github.com/4KInc/genuproof.git && cd genuproof && npm install
2

Test the server

npm run mcp
3

Add the configuration below to your AI client

Configuration

// Claude Code — .claude/settings.json or .mcp.json
{
  "mcpServers": {
    "genuproof": {
      "command": "node",
      "args": ["mcp/server.mjs"],
      "cwd": "/path/to/genuproof"
    }
  }
}

Set AUTHENTIK_BASE_URL to point to a different instance. Defaults to https://genuproof.com

What You Can Ask

“Register a luxury watch brand called Maison Noir”

brands_create

“Verify product wfPHybaFV3_a and show me the provenance chain”

products_verify

“Are there any active threats for my brand?”

threats_list

“Export the EU Digital Product Passport for this watch”

products_dpp_export

“Simulate a luxury watch journey from Switzerland to NYC”

integrations_simulate

“Show me all Gemini AI operations and their confidence scores”

ops_log

“Register 20 products in my handbag collection”

products_batch

“Set up a FedEx webhook integration for my brand”

integrations_configure

Tools Reference

44 tools across 8 categories. Each tool maps directly to an GenuProof API endpoint.

ToolDescription
brands_createRegister a new brand
brands_getGet a brand profile by ID
brands_listList all registered brands
brands_statsReal-time brand statistics (products, scans, threats)

How It Works

AI Assistant (Claude, Cursor, custom)
        |
        | JSON-RPC 2.0 over stdio
        |
   MCP Server (mcp/server.mjs)
        |
        | HTTP fetch (GET/POST/DELETE)
        |
   GenuProof API (Vercel)
    |         |          |
 DynamoDB   Lambda    Gemini 2.5
 (single    (threat   (AI threat
  table)    detect)   classify)

The MCP server translates natural-language tool calls into HTTP requests against the GenuProof API. Every tool returns structured JSON that the AI assistant can reason over and present to the user.

No API keys required for read operations. The server connects to the live production instance by default. Point AUTHENTIK_BASE_URL to a local dev server for development.

Environment Variables

AUTHENTIK_BASE_URL

Base URL of the GenuProof instance

default: https://genuproof.com

BASE_URL

Fallback base URL (if AUTHENTIK_BASE_URL not set)

default: https://genuproof.com

API ReferenceIntegrationsDashboardGitHub