BLINK Authority MCP Server

AI-native documentation tools for Claude, powered by the Model Context Protocol.

The BLINK Docs MCP Server gives Claude direct access to BLINK Authority documentation through structured tool calls, replacing copy-paste prompting with low-latency, cached lookups.

Installation

npx (no install required)

npx @blink-authority-com/docs-mcp

npm global install

npm install -g @blink-authority-com/docs-mcp
blink-docs-mcp

Claude Desktop

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "blink-docs": {
      "command": "npx",
      "args": ["@blink-authority-com/docs-mcp"]
    }
  }
}

Claude Code

Add to your Claude Code project configuration (.claude/settings.json):

{
  "mcpServers": {
    "blink-docs": {
      "command": "npx",
      "args": ["@blink-authority-com/docs-mcp"]
    }
  }
}

Available Tools

| Tool | Description | |------|-------------| | search_blink_docs | Full-text search across all BLINK documentation with TF-IDF ranking | | get_api_endpoint | Structured spec for a BLINK API endpoint (signing, verification, sessions, identity, hash, health) | | get_cli_command | Usage, flags, and examples for BLINK CLI commands (sign, verify, hash, keygen, inspect, config) | | get_sdk_guide | SDK integration guide for TypeScript, Rust, Go, or Python with code examples | | get_concept | Explanations of BLINK concepts (VDE, ephemeral keys, BSEC, identity hierarchy, etc.) | | list_available_docs | Index of all available documentation sections |

Configuration

CLI flags

| Flag | Description | Default | |------|-------------|---------| | --cache-ttl <seconds> | Cache time-to-live in seconds | 3600 (1 hour) | | --docs-url <url> | Base URL for documentation | https://place.blinkgateway.com |

Example with custom TTL

{
  "mcpServers": {
    "blink-docs": {
      "command": "npx",
      "args": ["@blink-authority-com/docs-mcp", "--cache-ttl", "7200"]
    }
  }
}

How It Works

1. On first run, the server fetches all documentation from place.blinkgateway.com/ai-assist/
2. Documents are cached locally at ~/.blink-mcp/cache/ for fast subsequent access
3. A TF-IDF search index is built in memory for full-text search
4. Claude calls tools via the MCP protocol over stdio
5. Responses are structured JSON with guardrails (max 2000 chars, summarise rather than reproduce)

Caching

• Cache location: ~/.blink-mcp/cache/
• Default TTL: 1 hour
• Offline mode: serves from stale cache when network is unavailable
• Stale data is served immediately while background refresh runs

Development

git clone https://github.com/blink-authority/blink-mcp
cd blink-mcp
npm install
npm run build
npm start

For development with hot reload:

npm run dev

Requirements

• Node.js 18 or later

License

MIT