Registry / llm-agents / agentdrop-mcp-server

agentdrop-mcp-server

JSON →
library0.2.22jsnpmunverified

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.

npm install agentdrop-mcp-server
INSTALL
IMPORT
SIG · AGENTDROP-MCP-SERV
A
agentdrop-mcp-server
llm-agentsjavascriptv0.2.22
Install
Import
Disk
Pass rate
0/ 6
Env Coverage0 / 6
glibc
1822
musl
1822
Install & Compatibility
Where this runs
tested against v? · npm install
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
musl
node 18226 runs
build_error
glibc
node 18226 runs
build_error
Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

AgentDropMCPServer
import { AgentDropMCPServer } from 'agentdrop-mcp-server'
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.
MCPServerConfig
import type { MCPServerConfig } from 'agentdrop-mcp-server'
TypeScript type for configuring the server when initializing `AgentDropMCPServer` programmatically. Useful for defining environment variables or other settings.
ToolDefinition
import type { ToolDefinition } from 'agentdrop-mcp-server'
TypeScript type representing the structure of a tool recognized by the MCP server. Useful for type-checking when developing custom tools or integrations.

Demonstrates how to install the `agentdrop-mcp-server` globally and how to configure an MCP client to launch it with necessary environment variables.

npm install -g agentdrop-mcp-server # Configure your MCP client (e.g., Claude Code, Cursor) to use this server. # This example shows a typical JSON configuration snippet for an MCP client. # Replace placeholders with your actual AgentDrop API key and agent IDs. # Ensure AGENTDROP_CONFIG_DIR points to a persistent directory for agent state. console.log('Starting AgentDrop MCP Server via npx...'); // This command would be executed by your MCP client, not directly run by you. // It sets environment variables for the server to pick up its configuration. // In a real scenario, this would be part of your MCP client's configuration. // Example of how an MCP client might invoke it: // You would typically configure this in your IDE/client settings, not run it manually. // This snippet demonstrates the required environment variables. const AGENTDROP_API_KEY = process.env.AGENTDROP_API_KEY ?? 'agd_your_api_key_here'; const AGENTDROP_AGENT_ID = process.env.AGENTDROP_AGENT_ID ?? 'your-agent-id-here'; const AGENTDROP_AGENT_UUID = process.env.AGENTDROP_AGENT_UUID ?? 'your-agent-uuid-here'; const AGENTDROP_CONFIG_DIR = process.env.AGENTDROP_CONFIG_DIR ?? '/path/to/.agentdrop'; console.log(` { "mcpServers": { "agentdrop": { "command": "npx", "args": ["agentdrop-mcp-server"], "env": { "AGENTDROP_API_KEY": "${AGENTDROP_API_KEY}", "AGENTDROP_AGENT_ID": "${AGENTDROP_AGENT_ID}", "AGENTDROP_AGENT_UUID": "${AGENTDROP_AGENT_UUID}", "AGENTDROP_CONFIG_DIR": "${AGENTDROP_CONFIG_DIR}" } } } } `); console.log('Ensure you have configured your MCP client to launch the server with these environment variables.'); console.log('Refer to docs.agent-drop.com for full setup instructions.');
Debug
Known issues
gotchaDo 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.
fix
Always use the provided MCP tools like `download_transfer` for file operations. Trust the built-in cryptography.
affects: >=0.2.0
breakingThis 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.
fix
Regularly check the official documentation at `docs.agent-drop.com` for release notes and migration guides before updating to new versions.
affects: >=0.x.x
gotchaRequires Node.js version 18.0.0 or higher. Running with older Node.js versions may lead to unexpected errors or silent failures.
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.
affects: <18.0.0
gotchaThe 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.
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.
affects: >=0.2.0
Errors
Common errors & fixes
Error: Command 'agentdrop-mcp-server' not found.
The `agentdrop-mcp-server` package was not installed globally or `npx` cannot locate it.
fix
Ensure you have installed the package globally using `npm install -g agentdrop-mcp-server` or that `npx` is correctly configured in your PATH.
Error: Missing required environment variable: AGENTDROP_API_KEY
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.
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`.
Node.js version mismatch: Expected >=18.0.0 but found v16.x.x
Your current Node.js version does not meet the minimum requirement specified in the package's `engines` field.
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.
Upgrade
Version history
0.2.22latest on npm
Audit
Dependencies

No dependency data recorded yet.

Agent activity
42 hits · last 30 days
node
34
Perplexity
1
OpenAI (training)
1
Resources
agentdrop-mcp-server — npm install agentdrop-mcp-server · libregistry