Gatekeeper MCP Server

MCP (Model Context Protocol) server for Archon Gatekeeper - provides DID resolution and search capabilities for AI agents.

Supports both local (stdio) and remote (HTTP/SSE) transports.

Features

• resolve_did - Resolve any DID to its full document
• search_dids - Full-text search across DID documents
• query_dids - Query DIDs by specific field criteria
• list_dids - List DIDs with optional time filters
• gatekeeper_status - Get node status and statistics
• list_registries - List available DID registries
• get_json / get_text - Retrieve IPFS content by CID

Installation

npm install @archon-protocol/gatekeeper-mcp-server

Or run directly:

npx @archon-protocol/gatekeeper-mcp-server

Configuration

Variable	Default	Description
ARCHON_GATEKEEPER_URL	https://archon.technology	Gatekeeper API URL
TRANSPORT	stdio	Transport mode: stdio or http
PORT	4251	HTTP server port (when TRANSPORT=http)
HOST	0.0.0.0	HTTP server host (when TRANSPORT=http)

Usage

Local Mode (stdio) - Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "archon-gatekeeper": {
      "command": "npx",
      "args": ["@archon-protocol/gatekeeper-mcp-server"],
      "env": {
        "ARCHON_GATEKEEPER_URL": "https://archon.technology"
      }
    }
  }
}

Remote Mode (HTTP/SSE) - Public Server

Run as an HTTP server for remote AI agents:

TRANSPORT=http PORT=4251 npx @archon-protocol/gatekeeper-mcp-server

Endpoints:

• POST /mcp - MCP Streamable HTTP endpoint
• GET /mcp - SSE stream for server-initiated messages
• GET /health - Health check

Public deployment at: https://mcp.archon.technology (coming soon)

Docker

FROM node:20-alpine
RUN npm install -g @archon-protocol/gatekeeper-mcp-server
ENV TRANSPORT=http
ENV PORT=4251
EXPOSE 4251
CMD ["gatekeeper-mcp-server"]

Example Queries

Resolve a DID

resolve_did: did:cid:bagaaieraxdxq4fm2kjh6yqjxjor3t2idczkmxd4v7in4u353fa6m6sms2pnq

Search for DIDs

search_dids: "genitrix"

Query DIDs by field

query_dids: {"didDocumentData.alias": "flaxscrip"}

Development

# Install dependencies
npm install

# Run in development mode (stdio)
npm run dev

# Run in HTTP mode
TRANSPORT=http npm run dev

# Build
npm run build

# Run production
npm start

Related

• @archon-protocol/mcp-server - Full Keymaster MCP server (wallet, credentials, DMail)
• Archon Protocol - Decentralized identity for AI agents

License

MIT