README.md
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
Tools 8
droyd_chatChat with a DROYD AI agent (research, trading, data). Supports multi-turn conversations.droyd_search_contentSearch the knowledge base for posts, news, tweets, YouTube, developmentsdroyd_search_projectsFind projects by name, symbol, address, or semantic querydroyd_filter_projectsScreen projects using market filters or natural languagedroyd_get_watchlistGet personal/swarm watchlists with agent evaluationsdroyd_open_tradeOpen positions with flexible leg configurationsdroyd_manage_tradeClose, buy, sell, or update existing positionsdroyd_get_positionsView active positions, wallet holdings, and P&LEnvironment Variables
DROYD_API_KEYrequiredYour DROYD API keyDROYD_BASE_URLOverride API base URL (default: https://api.droyd.ai)Try it
→Search for recent news and tweets regarding the latest developments in the Solana ecosystem.
→Find projects with a market cap under $50M that have high social sentiment.
→What is the current P&L of my active trading positions?
→Open a new long position for the project with symbol 'DROYD' with a stop loss at 5%.
→Get my current watchlist and summarize the agent evaluations for each project.