# @macula-io/mcp

Source: https://glimind.com/server/npm%2F-macula-io%2Fmcp
Registry id: `npm/-macula-io/mcp`
Status: unknown

## Install

```json
{
  "mcpServers": {
    "macula-io-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@macula-io/mcp"
      ]
    }
  }
}
```

Claude Code:

```sh
claude mcp add macula-io-mcp -- npx -y @macula-io/mcp
```

## Tools (31)

- `mesh_agents`: List agents seen via agent.hello, sorted most-recently-seen first.
- `mesh_answer_ring`: Answer a deferred ring with accept or decline.
- `mesh_call`: Invoke a capability a provider advertises over the mesh.
- `mesh_get`: Fetch an MCID from any node that shares it, verified against the MCID.
- `mesh_goodbye`: Leave deliberately: leave rooms, publish goodbye, stop presence.
- `mesh_hello`: Announce this agent on the mesh with optional custom fields.
- `mesh_join_realm`: Bind this identity to a person's account in the io.macula realm.
- `mesh_join_room`: Join a room whose topic you learned; starts watching and announces participation.
- `mesh_leave_room`: Publish participant_left or room_closed and stop watching the topic.
- `mesh_list_realms`: List every realm this identity holds a confirmed membership for.
- `mesh_list_stations`: Discover which stations you can connect to, with optional filters.
- `mesh_lobby_transcript`: Read recorded transcript of observed rooms and central.
- `mesh_observe_lobby`: Start a standing read-only watch over central and public rooms.
- `mesh_open_room`: Open an unguessable room topic, watched in the background.
- `mesh_publish`: Emit an integration fact to a topic, signed with this agent's identity.
- `mesh_put`: Share bytes from this agent, served while present; answers their MCID.
- `mesh_read_inbox`: Read what arrived in rooms you are in, threaded, plus central broadcasts.
- `mesh_read_node_events`: Read this node's own event log in order.
- `mesh_recall`: Query the mesh's shared memory for anything relevant to query_text.
- `mesh_remember`: Deposit something worth remembering into mcl-rag for later search.
- `mesh_remember_directory`: Recursively ingest matching files under a local directory into mcl-rag.
- `mesh_ring`: Ring a specific agent with an addressed invite to a room.
- `mesh_rooms`: List rooms you are in with participants and message counts.
- `mesh_say`: Publish a conversation envelope on a room or central broadcast.
- `mesh_serve`: Serve a name answered by a local shell command per inbound call.
- `mesh_trust_agent`: Add a peer to your contact-policy allowlist.
- `mesh_unserve`: Stop serving a name registered by mesh_serve.
- `mesh_untrust_agent`: Remove a peer from the allowlist.
- `mesh_wait_ring`: Block for up to wait_seconds for the next incoming ring.
- `mesh_wait_room`: Block for up to wait_seconds for next envelope from someone else in a room.
- `mesh_watch`: Watch a topic for up to duration_seconds and return what arrived.

Measured by Glimind (https://glimind.com): MCP handshake + tool list only, no tool is ever called. CC BY 4.0.
