DFNS MCP Server

A Model Context Protocol (MCP) server that provides AI agents with access to the DFNS documentation, API reference, and SDK code.

Features

• Full-Text Search: Instantly search across all DFNS guides, API docs, and SDK source code
• TypeScript Type Intelligence: Search and retrieve SDK type definitions with import paths
• Auto-Updating Docs: Documentation is fetched from docs.dfns.co on first run and cached locally
• Context Initialization: Dedicated init tool to enforce documentation-first behavior
• Smart Context: Retrieve specific documents, code examples, and API endpoint definitions
• SDK Intelligence: Mapped knowledge of supported blockchains and their SDK packages

Requirements

This MCP server requires Bun - a fast JavaScript runtime.

Linux/macOS:

curl -fsSL https://bun.sh/install | bash

Windows (PowerShell):

powershell -c "irm bun.sh/install.ps1 | iex"

Quick Start

Claude Code (Recommended)

claude mcp add -s user dfns-mcp -- bunx dfns-mcp@latest

The -s user flag installs to the user so it's available in all your projects.

Cursor

Add to your Cursor MCP settings (.cursor/mcp.json):

{
  "mcpServers": {
    "dfns-mcp": {
      "command": "bunx",
      "args": ["dfns-mcp@latest"]
    }
  }
}

Codex

codex mcp add dfns-mcp -- bunx dfns-mcp@latest

Gemini CLI

Add to your Gemini CLI config (~/.gemini/settings.json):

{
  "mcpServers": {
    "dfns-mcp": {
      "command": "bunx",
      "args": ["dfns-mcp@latest"]
    }
  }
}

Global Installation

If you prefer to install globally instead of using bunx:

bun install -g dfns-mcp

# Then reference as just "dfns-mcp" in your MCP config

Agent Instructions (Recommended)

Add this to your global ~/.claude/CLAUDE.md (or ~/AGENTS.md for other agents) to ensure your AI always uses up-to-date DFNS documentation:

## DFNS Development

When working with DFNS (wallet infrastructure, key management, blockchain integrations):

1. **Always** call `mcp__dfns-mcp__init` at the start of any DFNS-related task
2. **Never** rely on training data for DFNS APIs - always use `search_docs` and `get_doc` to verify
3. Use `search_types` and `get_type` to get accurate TypeScript type definitions
4. DFNS APIs and SDKs change frequently - the MCP server has the latest documentation

This prevents agents from hallucinating outdated API signatures or SDK patterns.

How It Works

On first run, the server automatically downloads the latest DFNS documentation from docs.dfns.co and SDK types from GitHub, caching them locally in ~/.cache/dfns-mcp/. The cache is refreshed every 24 hours automatically, or you can force an update using the update_docs tool.

Available Tools

Documentation Tools

Tool	Description
init	CALL THIS FIRST. Initializes the session and mandates strict documentation adherence
search_docs	Search all documentation and SDK files
get_doc	Retrieve the full content of a specific document
list_docs	List available documents by category
get_code_examples	Extract code snippets for a specific topic
browse_api_structure	View hierarchical API endpoint structure
get_api_endpoint	Get details for a specific API endpoint (e.g., POST /wallets)
get_blockchain_info	Get SDK package info for a specific chain (e.g., Solana)
list_blockchains	List all supported blockchains with their SDK packages

TypeScript Type Tools

Tool	Description
search_types	Search SDK types by name (e.g., "Wallet", "Signer", "Transaction")
get_type	Get full type definition, import path, and usage
list_types	List all types by category

Cache Management

Tool	Description
update_docs	Force update the documentation cache from docs.dfns.co and GitHub
cache_info	Get information about the cache (location, last update, etc.)

Resources

The server also exposes these quick-reference resources:

Resource URI	Description
dfns://quickref/authentication	Authentication patterns and code samples
dfns://quickref/sdk-setup	Package installation and setup guide
dfns://quickref/networks	All supported blockchain networks

Best Practices for Agents

When using this server, agents should follow this workflow:

1. Initialize: Call init immediately to establish the "Documentation First" protocol
2. Search: Use search_docs to find relevant information before answering ANY question
3. Read: Use get_doc to read the actual source material
4. Answer: Formulate responses based only on the retrieved context

Development

# Clone the repo
git clone https://github.com/jmaddington/dfns-mcp.git
cd dfns-mcp

# Install dependencies
bun install

# Run in development mode with auto-reload
bun run dev

# Test with MCP Inspector
bun run inspect

License

MIT