{"id":16758,"library":"agentdrop-mcp-server","title":"AgentDrop MCP Server","description":"The `agentdrop-mcp-server` package provides the Model Context Protocol (MCP) server for the AgentDrop ecosystem, facilitating secure, structured communication and tool access for AI agents. It acts as a core infrastructure component, enabling agents to send and receive files, manage connections, and execute predefined tools like `send_file` and `download_transfer` without needing to implement underlying cryptographic details (X25519/AES-256-GCM). The current stable version is 0.2.22, indicating an active development phase, though release cadence is not explicitly stated. Key differentiators include its tight integration with AgentDrop for AI agent communication, automatic encryption/decryption of file transfers, and self-updating agent profile retrieval, positioning it as a dedicated agent communication backbone rather than a general-purpose server.","status":"active","version":"0.2.22","language":"javascript","source_language":"en","source_url":"https://github.com/qFlav/AgentDrop","tags":["javascript","agentdrop","mcp","ai","agents","file-transfer","model-context-protocol","typescript"],"install":[{"cmd":"npm install agentdrop-mcp-server","lang":"bash","label":"npm"},{"cmd":"yarn add agentdrop-mcp-server","lang":"bash","label":"yarn"},{"cmd":"pnpm add agentdrop-mcp-server","lang":"bash","label":"pnpm"}],"dependencies":[],"imports":[{"note":"While primarily used as a CLI tool, this represents the main programmatic entry point for embedded or extended usage. Typically, you'd configure and start the server using this class.","symbol":"AgentDropMCPServer","correct":"import { AgentDropMCPServer } from 'agentdrop-mcp-server'"},{"note":"TypeScript type for configuring the server when initializing `AgentDropMCPServer` programmatically. Useful for defining environment variables or other settings.","symbol":"MCPServerConfig","correct":"import type { MCPServerConfig } from 'agentdrop-mcp-server'"},{"note":"TypeScript type representing the structure of a tool recognized by the MCP server. Useful for type-checking when developing custom tools or integrations.","symbol":"ToolDefinition","correct":"import type { ToolDefinition } from 'agentdrop-mcp-server'"}],"quickstart":{"code":"npm install -g agentdrop-mcp-server\n\n# Configure your MCP client (e.g., Claude Code, Cursor) to use this server.\n# This example shows a typical JSON configuration snippet for an MCP client.\n# Replace placeholders with your actual AgentDrop API key and agent IDs.\n# Ensure AGENTDROP_CONFIG_DIR points to a persistent directory for agent state.\n\nconsole.log('Starting AgentDrop MCP Server via npx...');\n\n// This command would be executed by your MCP client, not directly run by you.\n// It sets environment variables for the server to pick up its configuration.\n// In a real scenario, this would be part of your MCP client's configuration.\n\n// Example of how an MCP client might invoke it:\n// You would typically configure this in your IDE/client settings, not run it manually.\n// This snippet demonstrates the required environment variables.\nconst AGENTDROP_API_KEY = process.env.AGENTDROP_API_KEY ?? 'agd_your_api_key_here';\nconst AGENTDROP_AGENT_ID = process.env.AGENTDROP_AGENT_ID ?? 'your-agent-id-here';\nconst AGENTDROP_AGENT_UUID = process.env.AGENTDROP_AGENT_UUID ?? 'your-agent-uuid-here';\nconst AGENTDROP_CONFIG_DIR = process.env.AGENTDROP_CONFIG_DIR ?? '/path/to/.agentdrop';\n\nconsole.log(`\n{\n  \"mcpServers\": {\n    \"agentdrop\": {\n      \"command\": \"npx\",\n      \"args\": [\"agentdrop-mcp-server\"],\n      \"env\": {\n        \"AGENTDROP_API_KEY\": \"${AGENTDROP_API_KEY}\",\n        \"AGENTDROP_AGENT_ID\": \"${AGENTDROP_AGENT_ID}\",\n        \"AGENTDROP_AGENT_UUID\": \"${AGENTDROP_AGENT_UUID}\",\n        \"AGENTDROP_CONFIG_DIR\": \"${AGENTDROP_CONFIG_DIR}\"\n      }\n    }\n  }\n}\n`);\n\nconsole.log('Ensure you have configured your MCP client to launch the server with these environment variables.');\nconsole.log('Refer to docs.agent-drop.com for full setup instructions.');","lang":"typescript","description":"Demonstrates how to install the `agentdrop-mcp-server` globally and how to configure an MCP client to launch it with necessary environment variables."},"warnings":[{"fix":"Always use the provided MCP tools like `download_transfer` for file operations. Trust the built-in cryptography.","message":"Do NOT manually implement encryption or decryption logic. The `send_file` and `download_transfer` tools handle all cryptographic operations (X25519 and AES-256-GCM) automatically. Attempting manual implementation will introduce vulnerabilities and compatibility issues.","severity":"gotcha","affected_versions":">=0.2.0"},{"fix":"Regularly check the official documentation at `docs.agent-drop.com` for release notes and migration guides before updating to new versions.","message":"This package is in an early development stage (version 0.2.22), meaning breaking changes may occur frequently, even in minor versions. Always consult the official documentation before upgrading.","severity":"breaking","affected_versions":">=0.x.x"},{"fix":"Ensure your Node.js environment is updated to version 18.0.0 or later. Use `nvm` or similar tools to manage Node.js versions if needed.","message":"Requires Node.js version 18.0.0 or higher. Running with older Node.js versions may lead to unexpected errors or silent failures.","severity":"gotcha","affected_versions":"<18.0.0"},{"fix":"Verify that `AGENTDROP_API_KEY`, `AGENTDROP_AGENT_ID`, and `AGENTDROP_AGENT_UUID` environment variables are correctly set and correspond to an active AgentDrop agent with appropriate API access.","message":"The server automatically fetches agent profiles and updates every 5 minutes from `GET /v1/agents/me`. Ensure your AgentDrop API key and agent IDs (`AGENTDROP_API_KEY`, `AGENTDROP_AGENT_ID`, `AGENTDROP_AGENT_UUID`) are correctly configured and have the necessary permissions.","severity":"gotcha","affected_versions":">=0.2.0"}],"env_vars":null,"last_verified":"2026-04-22T00:00:00.000Z","next_check":"2026-07-21T00:00:00.000Z","problems":[{"fix":"Ensure you have installed the package globally using `npm install -g agentdrop-mcp-server` or that `npx` is correctly configured in your PATH.","cause":"The `agentdrop-mcp-server` package was not installed globally or `npx` cannot locate it.","error":"Error: Command 'agentdrop-mcp-server' not found."},{"fix":"Set all required environment variables in your MCP client's configuration or directly in your shell before launching the server. For example: `export AGENTDROP_API_KEY=agd_your_key`.","cause":"The MCP server requires specific environment variables (`AGENTDROP_API_KEY`, `AGENTDROP_AGENT_ID`, `AGENTDROP_AGENT_UUID`, `AGENTDROP_CONFIG_DIR`) to function, and one was not provided.","error":"Error: Missing required environment variable: AGENTDROP_API_KEY"},{"fix":"Upgrade your Node.js installation to version 18.0.0 or higher. Using `nvm install 18 && nvm use 18` is recommended for managing Node.js versions.","cause":"Your current Node.js version does not meet the minimum requirement specified in the package's `engines` field.","error":"Node.js version mismatch: Expected >=18.0.0 but found v16.x.x"}],"ecosystem":"npm","meta_description":null}