DROYD MCP 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