mayros serve
Start a Model Context Protocol (MCP) server that exposes 9 Mayros tools, Cortex resources, and workflow prompts. Any MCP-compatible client can connect and use Mayros capabilities, including Claude Desktop, Claude Code, IDE integrations, and remote agents.
Options
| Option | Description |
|---|---|
--stdio | Use stdio transport (for IDE integration) |
--http | Use HTTP transport (for remote clients) |
--port <port> | HTTP port (default: 19100) |
--host <host> | HTTP host (default: 127.0.0.1) |
Transports
- stdio — communicates over standard input/output, designed for IDE integrations and Claude Desktop. Logs go to stderr.
- HTTP — starts an HTTP server for remote MCP clients. Shows tool count, transport type, and discovered agents on startup.
If neither --stdio nor --http is specified, HTTP transport is used by default.
Cortex sidecar
The server automatically starts a Cortex sidecar on launch, providing persistent semantic memory, HNSW vector search, and the RDF knowledge graph. Data is stored at ~/.mayros/cortex-data/. The sidecar shuts down when the server stops.
Exposed capabilities
Tools (9)
| Tool | Category | Description |
|---|---|---|
mayros_remember | Memory | Store information with category, tags, and importance |
mayros_recall | Memory | Search memory by text, tags, or category |
mayros_search | Memory | Vector similarity search (HNSW-backed) |
mayros_forget | Memory | Delete a memory entry by ID |
mayros_budget | Budget | Check token usage and budget status |
mayros_policy_check | Governance | Evaluate if an action is allowed by project policies |
mayros_cortex_query | Cortex | Query the knowledge graph by subject/predicate/object |
mayros_cortex_store | Cortex | Store facts as RDF triples |
mayros_memory_stats | Cortex | Get memory system statistics |
Resources
Automatically discovered Markdown agents from project and user directories, plus conventions, rules, graph stats, and graph subjects.
Prompts
Conventions, rules, and agent identity prompts for each discovered agent.
Examples
bashmayros serve --stdio mayros serve --http mayros serve --http --port 19100 mayros serve --http --port 8080 --host 0.0.0.0
Related
- MCP Server — feature overview and setup guides
- mcp-setup — register Mayros in Claude Desktop or Claude Code
- MCP — MCP client management
- MCP Client — MCP client extension
- Agents — agent management