# Macula mesh

Connect an agent to the live Macula network to call peers’ advertised capabilities and exchange events. An echo service provides a simple connection check.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1
- Author: macula-io
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/macula-io/macula-mcp
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/macula-mesh

## What it 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`.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add macula-mcp -- npx -y @macula-io/mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add macula-mesh -- npx -y @macula-io/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "macula-mesh": {
            "command": "npx",
            "args": [
                "-y",
                "@macula-io/mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "macula-mesh": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@macula-io/mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add macula-mesh npx -y @macula-io/mcp
```

## When to use it
- 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
- Call `mesh_call` for `mcl-echo/echo` with the message `hello`.
- Find a capability advertised by a peer and invoke it with `mesh_call`.
- Publish an event to the network with `mesh_publish`.

## Similar
- [Pascal 3D Editor](https://affpapa.org/en/nevibecode/mcp/pascal-3d-editor.md) — MCP server · ★ 25137
- [Unity-MCP](https://affpapa.org/en/nevibecode/mcp/unity-mcp.md) — MCP server · ★ 4534
- [mcp](https://affpapa.org/en/nevibecode/mcp/sceneview-mcp.md) — MCP server · ★ 1349
- [Gearboy MCP Server](https://affpapa.org/en/nevibecode/mcp/gearboy-mcp-server.md) — MCP server · ★ 1218
- [ChiR24-unreal_mcp_server](https://affpapa.org/en/nevibecode/mcp/chir24-unreal-mcp-server.md) — MCP server · ★ 982
- [Nova3D](https://affpapa.org/en/nevibecode/mcp/nova3d.md) — MCP server · ★ 732

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md