Macula mesh — Claude Code MCP server: features and setup
Connect an agent to the live Macula network to call peers’ advertised capabilities and exchange events. An echo service provides a simple connection check.
claude mcp add macula-mcp -- npx -y @macula-io/mcpWhat Macula mesh does
Macula mesh links an MCP client to the Macula network. An agent can call capabilities advertised by other participants, publish messages, and watch for incoming events. Calls go directly to the provider. This connects to a real network, not a sandbox, and some features depend on having other peers there.
The server uses MCP over stdio to communicate with the agent and runs the network client through @macula-io/ts in the same process. To test it, ask the agent to call mesh_call with procedure mcl-echo/echo and the message hello; a public service returns the text. Node.js 24.18.1 or newer is required. For Claude Code, setup uses npx.
What it helps with
- call a capability advertised by a network participant
- publish an event for other agents
- watch for events arriving from peers
- test the connection with an echo call
Example prompts for the agent
- Call
mesh_callformcl-echo/echowith the messagehello. - Find a capability advertised by a peer and invoke it with
mesh_call. - Publish an event to the network with
mesh_publish.
How to install Macula mesh
Platform CLI
claude mcp add macula-mcp -- npx -y @macula-io/mcpPlatform CLI
codex mcp add macula-mesh -- npx -y @macula-io/mcpConfig file
{
"mcpServers": {
"macula-mesh": {
"command": "npx",
"args": [
"-y",
"@macula-io/mcp"
]
}
}
}Config file
{
"servers": {
"macula-mesh": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@macula-io/mcp"
]
}
}
}Platform CLI
gemini mcp add macula-mesh npx -y @macula-io/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Macula mesh
How do I install Macula mesh in Claude Code?
Run claude mcp add macula-mcp -- npx -y @macula-io/mcp to register the MCP server in Claude Code.
What does Macula mesh do?
It connects an agent to the federated Macula network so the agent can call peers’ advertised capabilities and exchange events.
How can I check that the server works?
Ask the agent to call mesh_call using procedure mcl-echo/echo and argument {"message":"hello"}. The public service returns the message.
