CertNode MCP Server

Enable AI assistants like Claude to verify content authenticity using CertNode's proof infrastructure.

Installation

npm install @certnode/mcp-server

Or run directly with npx:

npx @certnode/mcp-server

Configuration

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "certnode": {
      "command": "npx",
      "args": ["@certnode/mcp-server"]
    }
  }
}

Custom API URL

Set the CERTNODE_API_URL environment variable to use a different API endpoint:

{
  "mcpServers": {
    "certnode": {
      "command": "npx",
      "args": ["@certnode/mcp-server"],
      "env": {
        "CERTNODE_API_URL": "https://your-instance.example.com/api/v1"
      }
    }
  }
}

Available Tools

verify_content

Verify the authenticity of content by URL or SHA-256 hash.

Parameters:

• url (string, optional): URL of the content to verify
• hash (string, optional): SHA-256 hash of the content
• mode (string, optional): "quick" or "full" (default: "quick")

Example:

Can you verify if this content is authentic?
URL: https://example.com/article.html

search_registry

Search the CertNode public content registry.

Parameters:

• query (string, required): Search query
• type (string, optional): Filter by proof type
• limit (number, optional): Max results (default: 10, max: 50)

Example:

Search the CertNode registry for proofs from "Acme Corp"

get_proof

Get detailed information about a specific proof.

Parameters:

• proof_id (string, required): The proof ID

Example:

Get details for proof prf_abc123xyz

get_trust_score

Calculate the trust score for content.

Parameters:

• url (string, optional): URL of the content
• hash (string, optional): SHA-256 hash

Example:

What's the trust score for this article? URL: https://example.com/news

Trust Levels

The trust score system uses four levels:

| Level | Score | Meaning | |-------|-------|---------| | Certified | 90-100 | Multiple verification layers, verified creator, established age | | Verified | 70-89 | Strong cryptographic proof with additional verification | | Basic | 40-69 | Cryptographic proof present but limited verification | | Unverified | 0-39 | No proof found or minimal verification |

Response Format

All tools return JSON responses with relevant data. For example:

{
  "verified": true,
  "confidence": 0.95,
  "trust_score": {
    "score": 75,
    "level": "verified"
  },
  "proof": {
    "id": "prf_abc123xyz",
    "type": "receipt",
    "created_at": "2025-12-24T10:30:00Z"
  },
  "verify_url": "https://certnode.io/verify/prf_abc123xyz"
}

Use Cases

Fact-Checking

"Can you verify if this news article has a CertNode proof?"

Content Attribution

"Search the registry for content by this creator"

Trust Assessment

"What's the trust score for this document?"

Proof Lookup

"Get me the full details for proof ID prf_xyz123"

Development

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build for production
npm run build

# Run production build
npm start

License

MIT