Mayros
Production-ready AI agent framework — semantic memory, multi-agent mesh, MCP server, intelligent routing, governance, and 67+ platform integrations.
What is Mayros?
Mayros is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to production-ready ai agent framework — semantic memory, multi-agent mesh, mcp server, intelligent routing, governance, and 67+ platform integrations.
Production-ready AI agent framework — semantic memory, multi-agent mesh, MCP server, intelligent routing, governance, and 67+ platform integrations.
This server falls under the Coding Agents category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Production-ready AI agent framework — semantic memory, multi
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx mayrosConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Mayros
Mayros is a production-ready AI agent framework with a built-in MCP server that exposes 45+ tools covering semantic memory, knowledge graph queries, multi-agent coordination, budget governance, and 17+ messaging channel integrations including WhatsApp, Telegram, Slack, and Discord. It connects to Claude Desktop, Claude Code, Cursor, and VS Code via a single WebSocket gateway and a QuickJS WASM sandbox for secure tool execution.
Prerequisites
- Node.js 22.12.0 or newer
- npm, pnpm, or bun package manager
- An MCP-compatible AI client such as Claude Desktop or Claude Code
- API keys for any messaging channels you want to connect (Telegram, Slack, Discord, etc.)
Install Mayros globally
Install the Mayros CLI globally from npm. This provides the mayros command used to start the gateway, run agents, and manage the MCP server.
npm install -g @apilium/mayros@latestRun the onboarding wizard
Run the onboarding command to install the background daemon, set up the AIngle Cortex semantic memory sidecar, and initialise your Mayros configuration.
mayros onboard --install-daemonStart the WebSocket gateway
Start the gateway that connects all clients, channels, and tools. By default it binds to ws://127.0.0.1:18789.
mayros gateway --port 18789 --verboseRegister with your MCP client
Use the built-in setup command to automatically write the MCP server entry to Claude Desktop or Claude Code configuration.
mayros mcp-setup --desktop
# or for Claude Code:
mayros serve --http # Starts HTTP MCP endpoint at port 19100Configure messaging channel credentials (optional)
Add credentials for any messaging channels you want to connect. Each channel is configured in the Mayros config file or via environment variables.
# Telegram
export TELEGRAM_BOT_TOKEN=your-bot-token
# Slack
export SLACK_BOT_TOKEN=xoxb-your-bot-token
export SLACK_APP_TOKEN=xapp-your-app-token
# Discord
export DISCORD_BOT_TOKEN=your-discord-bot-tokenVerify available MCP tools
Open your AI client and ask it to list available Mayros tools. You should see tools in the mayros_* namespace covering memory, knowledge graph, DAG operations, budget, and ventures.
Mayros Examples
Client configuration
Claude Desktop configuration connecting to the Mayros MCP server over HTTP. Start the HTTP server with mayros serve --http before connecting.
{
"mcpServers": {
"mayros": {
"type": "http",
"url": "http://127.0.0.1:19100/mcp"
}
}
}Prompts to try
Use these prompts to interact with Mayros tools through the AI agent.
- "Remember that our API rate limit is 1000 requests per minute for future reference"
- "Search my Mayros memory for anything related to the Q3 project decisions"
- "Show me the knowledge graph stats and list all available namespaces"
- "Create a Kaneru venture called 'Website Redesign' with prefix WEB"
- "List all active background tasks and their current status"Troubleshooting Mayros
mayros command not found after npm install -g
The global npm bin directory may not be in PATH. Run npm prefix -g to find the global prefix and add <prefix>/bin to your PATH. On macOS with nvm, each node version has its own global bin — ensure you are using Node.js 22.12.0+.
MCP client cannot connect to the HTTP endpoint
Verify mayros serve --http is running and listening on port 19100 by running curl http://127.0.0.1:19100/mcp. If the gateway (port 18789) is not running, start it first with mayros gateway, then start the MCP HTTP server.
Semantic memory tools return empty results
The AIngle Cortex sidecar must be running for memory tools to work. Check its status with mayros status and restart it with mayros onboard --install-daemon if needed. Memory is namespace-isolated — ensure you are querying the correct namespace.
Frequently Asked Questions about Mayros
What is Mayros?
Mayros is a Model Context Protocol (MCP) server that production-ready ai agent framework — semantic memory, multi-agent mesh, mcp server, intelligent routing, governance, and 67+ platform integrations. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Mayros?
Follow the installation instructions on the Mayros GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Mayros?
Mayros works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Mayros free to use?
Yes, Mayros is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Mayros Alternatives — Similar Coding Agents Servers
Looking for alternatives to Mayros? Here are other popular coding agents servers you can use with Claude, Cursor, and VS Code.
Dify
★ 142.2kProduction-ready platform for agentic workflow development.
Ruflo
★ 54.0k🌊 The leading agent orchestration platform for Claude. Deploy intelligent multi-agent swarms, coordinate autonomous workflows, and build conversational AI systems. Features enterprise-grade architecture, self-learning swarm intelligence, RAG integrat
Goose
★ 45.7kan open source, extensible AI agent that goes beyond code suggestions - install, execute, edit, and test with any LLM
Antigravity Awesome Skills
★ 38.3kInstallable GitHub library of 1,400+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.
AgentScope
★ 25.5kBuild and run agents you can see, understand and trust.
Serena
★ 24.5kA coding agent toolkit that provides IDE-like semantic code retrieval and editing tools, enabling LLMs to efficiently navigate and modify codebases using symbol-level operations instead of basic file reading and string replacements.
Browse More Coding Agents MCP Servers
Explore all coding agents servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Mayros in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Mayros?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.