DROYD MCP Server

Chat with a DROYD AI agent. Supports multi-turn conversations.

Agent Types:

• research - Deep research on crypto projects, trends, and market analysis

• trading - Trading signals, momentum analysis, entry/exit recommendations

• data - Market data queries, on-chain metrics, project statistics

• chat - General conversational assistant

• agent - Full capabilities with all tools

Multi-turn Conversations: Include the conversation_uuid from a previous response to continue the conversation.

Examples:

• Start new chat: { "message": "What are the top DeFi trends?" }

• Continue conversation: { "message": "Tell me more about the first one", "conversation_uuid": "abc-123" }

• Trading analysis: { "message": "Analyze SOL momentum", "agent_type": "trading" }

Search the DROYD knowledge base for crypto content.

Search Modes:

• recent - Browse latest content by type, category, or ecosystem

• semantic - AI-powered search with natural language query

Content Types: posts, news, developments, tweets, youtube, memories, concepts

Categories: defi, nfts, gaming, ai, memecoins, stablecoins, rwas, depin, wallets, etc.

Ecosystems: solana, ethereum, base, bitcoin, arbitrum, optimism, polygon, avalanche, etc.

Examples:

• Recent DeFi news: { "search_mode": "recent", "content_types": ["news"], "categories": ["defi"], "days_back": 7 }

• Semantic search: { "search_mode": "semantic", "query": "AI agents in crypto", "include_analysis": true }

• Ecosystem research: { "search_mode": "recent", "ecosystems": ["solana", "base"], "content_types": ["posts", "tweets"] }

Search for crypto projects by name, symbol, address, or semantic query.

Search Types:

• project_id - Direct ID lookup (fastest)

• name - Search by project name (e.g., "Jupiter", "Raydium")

• symbol - Search by ticker symbol (e.g., "JUP", "RAY", "SOL")

• address - Search by contract address (exact match)

• semantic - AI-powered concept search (e.g., "AI agents in DeFi")

Attributes: developments, recent_content, technical_analysis, market_data, mindshare, detailed_description, metadata

Examples:

• By name: { "search_type": "name", "queries": ["Jupiter", "Raydium"] }

• By symbol: { "search_type": "symbol", "queries": ["SOL", "ETH", "BTC"] }

• Semantic: { "search_type": "semantic", "queries": ["liquid staking protocols on Solana"] }

• With data: { "search_type": "name", "queries": ["Bitcoin"], "include_attributes": ["market_data", "technical_analysis"] }

Filter and screen crypto projects using market criteria.

Filter Modes:

• natural_language - Describe what you want (e.g., "trending micro-cap Solana tokens")

• direct - Use specific filter parameters

Sort Options: market_cap, price_change, traders, traders_change, volume, volume_change, buy_volume_ratio, quant_score, quant_score_change, mentions_24h, mentions_7d

Chains: solana, ethereum, base, arbitrum

Note: Market cap values are in MILLIONS (e.g., max_market_cap: 10 = $10M)

Examples:

• Natural language: { "filter_mode": "natural_language", "instructions": "Find trending micro-cap Solana tokens with high trader growth" }

• Direct filters: { "filter_mode": "direct", "sort_by": "traders_change", "tradable_chains": ["solana"], "max_market_cap": 10, "min_liquidity": 50000 }

• Oversold tokens: { "filter_mode": "direct", "sort_by": "quant_score", "sort_direction": "asc", "max_rsi": 30 }

Get watchlist projects for the authenticated user.

Scopes:

• agent - Personal agent watchlist only

• swarm - Community swarm watchlists

• combined - Both personal and swarm (default)

Returns projects with agent evaluations including investment scores and thesis points.

Examples:

• Get combined: { "scope": "combined" }

• Agent only: { "scope": "agent", "include_attributes": ["market_data", "technical_analysis"] }

• With limit: { "scope": "swarm", "limit": 10 }

Open a new trading position with flexible leg configurations.

Leg Types & Trigger Interpretation:

• market_buy - Immediate buy at market price (no trigger needed)

• limit_order - Buy when price drops by triggerPercent (0.05 = buy at 5% below current)

• stop_loss - Sell when price drops by triggerPercent (0.10 = sell at 10% below entry)

• take_profit - Sell when price rises by triggerPercent (0.20 = sell at 20% above entry)

• quant_buy - Buy when momentum score reaches triggerPercent (e.g., 15)

• quant_sell - Sell when momentum score reaches triggerPercent (e.g., -10)

Examples:

• Simple buy: { "project_id": 123, "legs": [{ "type": "market_buy", "amountUSD": 100 }] }

• With stop loss: { "project_id": 123, "legs": [ { "type": "market_buy", "amountUSD": 100 }, { "type": "stop_loss", "amountUSD": 100, "triggerPercent": 0.15 } ]}

• Scaled take profits: { "project_id": 123, "legs": [ { "type": "market_buy", "amountUSD": 100 }, { "type": "stop_loss", "amountUSD": 100, "triggerPercent": 0.10 }, { "type": "take_profit", "amountUSD": 50, "triggerPercent": 0.25, "positionPercent": 0.5 }, { "type": "take_profit", "amountUSD": 50, "triggerPercent": 0.50, "positionPercent": 0.5 } ]}

Manage existing trading positions. Close positions, execute additional buys/sells, or modify strategy legs.

Actions:

• close - Exit entire position at market

• buy - Add to existing position (requires amountUSD)

• sell - Partial exit (requires sellPercent, e.g., 0.5 = sell 50%)

• update - Modify stop losses and take profits

Examples:

• Close position: { "strategy_id": 789, "action": "close" }

• Partial sell: { "strategy_id": 789, "action": "sell", "sellPercent": 0.25 }

• Add buy: { "strategy_id": 789, "action": "buy", "amountUSD": 50 }

• Add stop loss: { "strategy_id": 789, "action": "update", "legs": [ { "leg_action": "add", "type": "stop_loss", "amountUSD": 100, "triggerPercent": 0.10 } ]}

• Update existing leg: { "strategy_id": 789, "action": "update", "legs": [ { "leg_action": "update", "leg_id": 123, "triggerPercent": 0.15 } ]}

• Remove leg: { "strategy_id": 789, "action": "update", "legs": [ { "leg_action": "remove", "leg_id": 456 } ]}

Retrieve active trading positions and wallet holdings.

Returns:

• All active strategies with their legs (stop losses, take profits, etc.)

• Executed swaps history

• P&L summary (realized, unrealized, total)

• Wallet holdings with current values

• Overall portfolio summary

Use leg_status="all" to include executed/completed legs in the response.

Examples:

• Active only: { "leg_status": "active" }

• Include history: { "leg_status": "all" }