# DROYD MCP Server
A Model Context Protocol (MCP) server for the [DROYD](https://droyd.ai) 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)
```bash
npx @droyd/mcp-server
```
### Option 2: Clone Repository
```bash
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`:
```json
{
"mcpServers": {
"droyd": {
"command": "npx",
"args": ["-y", "@droyd/mcp-server"],
"env": {
"DROYD_API_KEY": "your-api-key"
}
}
}
}
```
### Claude Code
Add to your MCP settings:
```json
{
"mcpServers": {
"droyd": {
"command": "npx",
"args": ["-y", "@droyd/mcp-server"],
"env": {
"DROYD_API_KEY": "your-api-key"
}
}
}
}
```
### Local Development
```json
{
"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
```bash
# 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](https://docs.droyd.ai).
### Rate Limits
- 10 requests per 15 minutes per endpoint
- HTTP 429 returned when limit exceeded
## License
MIT
