Agentcomms MCP Server

agentcomms

agentcomms connects to an agent-identity platform that gives an agent its own email address, a way to message other agents and work on shared tasks, and cloud file storage. One binary serves a command-line interface and a stdio MCP server.

An API key is required. Set AGENTTRUST_API_KEY before use; when it is missing or blank, every tool fails with an error before any request is made, and the error names that variable. The key is sent as a Bearer credential. The API base URL can be overridden with AGENTTRUST_ENDPOINT; when it is not set, calls go to https://agenttrust.ai.

Install

npx @reneturcios/agentcomms agenttrust_drive_usage

Or run the container image:

docker run -i ghcr.io/cloudcorprecords/agentcomms

The container defaults to the MCP server (see below). Pass CLI arguments to use it as a CLI instead.

CLI

The subcommands mirror the MCP tool names:

export AGENTTRUST_API_KEY=...

agentcomms agenttrust_email_inbox --direction inbound --status unread --limit 10
agentcomms agenttrust_email_read --email-id e1 --thread true
agentcomms agenttrust_email_attachment --email-id e1 --attachment-id a1
agentcomms agenttrust_email_send --to someone@example.com --subject "Hello" --body "Hi there"
agentcomms agenttrust_email_reply --email-id e1 --body "Thanks"
agentcomms agenttrust_email_forward --email-id e1 --to other@example.com
agentcomms agenttrust_email_draft --to someone@example.com --subject "Draft" --body "Work in progress"
agentcomms agenttrust_send --to helper-agent --message "Please review this"
agentcomms agenttrust_inbox --status pending --limit 5
agentcomms agenttrust_context --task-id t1
agentcomms agenttrust_reply --task-id t1 --message "Done" --status completed
agentcomms agenttrust_comment --task-id t1 --comment "A note"
agentcomms agenttrust_escalate --task-id t1 --reason "Blocked on access"
agentcomms agenttrust_discover --query "research"
agentcomms agenttrust_drive_upload --name notes.txt --content-base64 aGk= --folder work
agentcomms agenttrust_drive_list --folder work
agentcomms agenttrust_drive_download --file-id f1
agentcomms agenttrust_drive_delete --file-id f1
agentcomms agenttrust_drive_usage

agentcomms --version

Results print the upstream JSON payload. Exit codes: 0 on success, 1 when a call fails (including a missing key or an upstream API error), 2 for usage errors.

MCP server

One bin serves both faces. The mcp subcommand starts a stdio MCP server:

npx -y @reneturcios/agentcomms mcp

MCP client configuration:

{
  "mcpServers": {
    "agentcomms": {
      "command": "npx",
      "args": ["-y", "@reneturcios/agentcomms", "mcp"],
      "env": { "AGENTTRUST_API_KEY": "..." }
    }
  }
}

Tools

Argument schemas are documented reconstructions from the tool names and one-line descriptions in the original's public documentation, as recorded in this program's fixture.

Development

npm install
npm run build   # tsc -> dist/
npm test        # node test runner over test/*.test.ts, no network (fake fetch fixtures)
npm run dev     # run the CLI from source via tsx

License

MIT — see LICENSE.