DROYD Server

A Model Context Protocol (MCP) server for the DROYD AI trading agent API. This server enables Claude Desktop, Claude Code, and other MCP clients to interact with DROYD's crypto research, project discovery, and trading capabilities.

Features

• Agent Chat - Multi-turn conversations with DROYD AI agents (research, trading, data)
• Content Search - Search DROYD's knowledge base for crypto news, posts, tweets, and more
• Project Discovery - Find projects by name, symbol, address, or semantic concepts
• Market Screening - Filter projects using market criteria or natural language
• Watchlists - Access personal and swarm watchlists with agent evaluations
• Trading - Open positions with flexible leg configurations (stops, takes, etc.)
• Position Management - Manage trades and view P&L

Installation

Option 1: npm (Recommended)

npx @droyd/mcp-server

Option 2: Clone Repository

git clone https://github.com/droyd/mcp-server.git
cd mcp-server
npm install
npm run build

Configuration

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "droyd": {
      "command": "npx",
      "args": ["-y", "@droyd/mcp-server"],
      "env": {
        "DROYD_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Code

Add to your MCP settings:

{
  "mcpServers": {
    "droyd": {
      "command": "npx",
      "args": ["-y", "@droyd/mcp-server"],
      "env": {
        "DROYD_API_KEY": "your-api-key"
      }
    }
  }
}

Local Development

{
  "mcpServers": {
    "droyd": {
      "command": "node",
      "args": ["/path/to/droyd-mcp-server/dist/index.js"],
      "env": {
        "DROYD_API_KEY": "your-api-key"
      }
    }
  }
}

Environment Variables

Variable	Required	Description
DROYD_API_KEY	Yes	Your DROYD API key
DROYD_BASE_URL	No	Override API base URL (default: https://api.droyd.ai)

Available Tools

Agent

Tool	Description
droyd_chat	Chat with a DROYD AI agent (research, trading, data). Supports multi-turn conversations.

Search

Tool	Description
droyd_search_content	Search the knowledge base for posts, news, tweets, YouTube, developments

Projects

Tool	Description
droyd_search_projects	Find projects by name, symbol, address, or semantic query
droyd_filter_projects	Screen projects using market filters or natural language
droyd_get_watchlist	Get personal/swarm watchlists with agent evaluations

Trading

Tool	Description
droyd_open_trade	Open positions with flexible leg configurations
droyd_manage_trade	Close, buy, sell, or update existing positions
droyd_get_positions	View active positions, wallet holdings, and P&L

Development

# Install dependencies
npm install

# Build
npm run build

# Run in development mode
npm run dev

# Type check
npm run typecheck

# Lint
npm run lint

API Reference

For detailed API documentation, see DROYD API Docs.

Rate Limits

• 10 requests per 15 minutes per endpoint
• HTTP 429 returned when limit exceeded

License

MIT