@blink-authority-com/claude-code-plugin

BLINK Authority's Claude Code Plugin -- AI-native development tools for ephemeral cryptographic signing. This MCP (Model Context Protocol) server gives Claude direct access to BLINK documentation, code scaffolding, signing envelope tools, and optional live BSEC integration for real-time composite derivation signing and verification.

Installation

Claude Code (CLI)

claude mcp add blink -- npx @blink-authority-com/claude-code-plugin

Or add to your project's .mcp.json:

{
  "mcpServers": {
    "blink": {
      "command": "npx",
      "args": ["@blink-authority-com/claude-code-plugin"]
    }
  }
}

Claude Desktop

Add to your Claude Desktop configuration file:

{
  "mcpServers": {
    "blink": {
      "command": "npx",
      "args": ["@blink-authority-com/claude-code-plugin"]
    }
  }
}

Available Tools

| Tool | Description | Example Usage | |------|-------------|---------------| | search_blink_docs | Search BLINK documentation | "How do I verify a VDE signature?" | | get_api_endpoint | Get API endpoint specs | "Show me the signing endpoint" | | get_cli_command | Get CLI command help | "How do I use blink sign?" | | get_sdk_guide | Get SDK integration guide | "TypeScript signing guide" | | get_concept | Explain a BLINK concept | "What is VDE key derivation?" | | list_available_docs | List all doc sections | "What docs are available?" | | blink_scaffold | Generate a BLINK project | "Create an express-api project" | | blink_add_signing | Add signing to existing code | "Add BLINK signing to this handler" | | blink_decode_envelope | Decode a signature envelope | "Decode this base64 envelope" | | blink_generate_test_vectors | Generate mock test vectors | "Generate 5 Ed25519 test vectors" | | blink_verify_local | Offline format verification | "Verify this envelope format" | | blink_lint | Lint for BLINK best practices | "Check this code for BLINK issues" | | blink_hierarchy_design | Design a key hierarchy | "Design keys for my org" | | blink_sign_test | Live BSEC signing (connected) | "Sign this payload with BSEC" | | blink_verify_test | Live BSEC verification (connected) | "Verify this envelope with BSEC" |

Resources and Prompts

Resources (available via MCP resource protocol):

• blink://patterns -- Common BLINK integration patterns
• blink://errors -- Error codes with causes and fixes
• blink://changelog -- Recent BLINK SDK/CLI/BSEC changes

Prompts (available via MCP prompt protocol):

• blink-review -- Review code for BLINK integration best practices
• blink-integrate -- Guide BLINK integration into an existing project
• blink-debug -- Debug signing or verification issues

Connected Mode

Connected mode enables live signing and verification through a BSEC instance. This is optional -- all other tools work offline.

claude mcp add blink -- npx @blink-authority-com/claude-code-plugin \
  --bsec-url https://your-bsec:8443 \
  --bsec-token YOUR_SESSION_TOKEN

Or in .mcp.json:

{
  "mcpServers": {
    "blink": {
      "command": "npx",
      "args": [
        "@blink-authority-com/claude-code-plugin",
        "--bsec-url", "https://your-bsec:8443",
        "--bsec-token", "your-session-token"
      ]
    }
  }
}

When connected mode is enabled:

• blink_sign_test sends payloads to BSEC for composite derivation signing
• blink_verify_test performs server-side cryptographic verification
• All connected tool responses include a warning that data is sent externally
• Credentials are never logged or included in error messages

For self-signed BSEC certificates, set NODE_TLS_REJECT_UNAUTHORIZED=0 in your environment.

Examples

1. Scaffold a New Project

"Create a BLINK notary service called my-notary in TypeScript"

Claude will use blink_scaffold to generate a complete project with BSEC integration, signing middleware, and health checks.

2. Debug a Verification Failure

"I'm getting a derivation proof chain error. Here's my code: ..."

Claude will use blink_lint to check for common mistakes, get_concept to explain VDE verification, and blink-debug prompt for structured troubleshooting.

3. Review Integration Code

"Review this signing handler for BLINK best practices"

Claude will use blink_lint and the blink-review prompt to analyze your code for error handling, key lifecycle issues, and security patterns.

Configuration Options

| Option | Description | Default | |--------|-------------|---------| | --bsec-url | BSEC instance URL for connected mode | (none -- offline mode) | | --bsec-token | BSEC session token for authentication | (none -- offline mode) | | --cache-ttl | Documentation cache TTL in seconds | 3600 | | --docs-url | Custom BLINK documentation URL | https://docs.blink-authority.com |

License

MIT -- see LICENSE for details.

Links

• BLINK Authority
• npm package
• Documentation
• BLINK GitHub