Dynamic Labs MCP Server

A comprehensive Model Context Protocol (MCP) server that provides Claude Code with full access to Dynamic Labs documentation, GitHub repositories, API references, and code examples.

Features

🔍 Search Dynamic Documentation - Search across all Dynamic Labs documentation sections
📖 Get Specific Pages - Fetch detailed content from any documentation page
📚 LLM-Friendly Documentation Index - Navigate using Dynamic's structured documentation index
🗺️ Section-Based Navigation - Browse documentation by specific sections (auth, wallets, SDK)
🐙 GitHub Integration - Search and browse Dynamic Labs repositories
📁 Repository Content - Access specific files, READMEs, and code examples
📋 Repository Listing - Get an overview of all Dynamic Labs projects

Installation

Quick Start with Claude Code

# Add to Claude Code (recommended)
claude mcp add dynamic --scope user -- npx dynamic-mcp-server

# Verify installation
claude mcp list

Global Installation

# Install globally
npm install -g dynamic-mcp-server

# Add to Claude Code using local installation
claude mcp add dynamic --scope user -- dynamic-mcp-server

Local Development

# Clone and install
git clone https://github.com/your-username/dynamic-mcp-server.git
cd dynamic-mcp-server
npm install

# Add to Claude Code
claude mcp add dynamic --scope project -- node /path/to/dynamic-mcp-server.js

Available Tools

search_dynamic_docs

Search across Dynamic Labs documentation for specific topics, features, or implementation guides.

Parameters:

• query (string): Search query for Dynamic documentation

Example:

{
  "name": "search_dynamic_docs",
  "arguments": {
    "query": "wallet authentication"
  }
}

get_dynamic_page

Fetch the full content of a specific Dynamic documentation page.

Parameters:

• url (string): URL path of the Dynamic docs page (e.g., "/docs/introduction/welcome")

Example:

{
  "name": "get_dynamic_page",
  "arguments": {
    "url": "/docs/api-reference/overview"
  }
}

search_github_repos

Search Dynamic Labs GitHub repositories for code examples, implementations, or specific functionality.

Parameters:

• query (string): Search query for GitHub repositories and code

Example:

{
  "name": "search_github_repos",
  "arguments": {
    "query": "wallet connector"
  }
}

get_repo_content

Get content from a specific file or directory in a Dynamic Labs repository.

Parameters:

• repo (string): Repository name (e.g., "public-wallet-connectors")
• path (string, optional): File or directory path within the repository

Example:

{
  "name": "get_repo_content",
  "arguments": {
    "repo": "public-wallet-connectors",
    "path": "README.md"
  }
}

list_dynamic_repos

List all available Dynamic Labs GitHub repositories.

Example:

{
  "name": "list_dynamic_repos",
  "arguments": {}
}

get_documentation_index

Get Dynamic's structured documentation index with LLM-friendly descriptions and navigation paths.

Example:

{
  "name": "get_documentation_index",
  "arguments": {}
}

navigate_docs_by_section

Navigate documentation by specific section (e.g., "authentication", "wallets", "sdk").

Parameters:

• section (string): Documentation section to navigate

Example:

{
  "name": "navigate_docs_by_section",
  "arguments": {
    "section": "authentication"
  }
}

Usage Examples

With Claude Code

Once installed, you can ask Claude Code questions like:

• "Search Dynamic docs for wallet integration examples"
• "Get the Dynamic API reference overview page"
• "Show me the Dynamic documentation index"
• "Navigate to the authentication section of the docs"
• "Show me the Dynamic wallet connectors repository"
• "Find React examples in Dynamic's GitHub repos"
• "List all Dynamic Labs repositories"

Claude Code will automatically use the appropriate tools to fetch and present the information.

Manual Testing

You can test the server directly:

# Run the server
node dynamic-mcp-server.js

# The server will start and wait for MCP protocol messages on stdin/stdout

Data Sources

This MCP server aggregates information from:

• Dynamic Labs Documentation (https://www.dynamic.xyz/docs/)

  • Learn section (features, dashboard, security)
  • Implement section (integration guides)
  • References (SDK/API documentation)
  • Guides (framework-specific implementations)
  • Troubleshooting guides

• Dynamic Labs GitHub (https://github.com/dynamic-labs)

  • SDK repositories
  • Wallet connector implementations
  • Example projects and templates
  • Boilerplate code
  • Documentation repositories

Requirements

• Node.js 18.0.0 or higher
• Claude Code installed and configured
• Internet connection for fetching Dynamic Labs content

Configuration

Scopes

When adding to Claude Code, you can use different scopes:

• --scope user: Available across all your projects (recommended)
• --scope project: Only available in current project
• --scope local: Private to you in current project

Environment Variables

No environment variables are required. The server uses public APIs and documentation.

Rate Limiting

The server includes built-in rate limiting and error handling:

• Requests timeout after 5-10 seconds
• GitHub API requests include proper headers
• Graceful error handling for network issues

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test with Claude Code
5. Submit a pull request

Troubleshooting

Server Won't Start

# Check Node.js version
node --version  # Should be 18.0.0+

# Test dependencies
npm test

# Check Claude Code configuration
claude mcp list

Connection Issues

# Remove and re-add the server
claude mcp remove dynamic
claude mcp add dynamic --scope user -- npx dynamic-mcp-server

# Check server health
claude mcp get dynamic

Network Errors

• Ensure internet connection is stable
• GitHub API has rate limits (60 requests/hour for unauthenticated)
• Dynamic's documentation site must be accessible

License

MIT License - see LICENSE file for details.

Related Projects

• Model Context Protocol - Official MCP documentation
• Dynamic Labs - Wallet infrastructure platform
• Claude Code - AI-powered development environment

Support

• GitHub Issues
• Dynamic Labs Documentation
• MCP Specification