macula-mcpBLOCK
MCP server that gives Claude Code, Cursor, opencode and any agent harness shared memory, identity and messaging over the Macula mesh
Overview
From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.
[](https://github.com/macula-io/macula-mcp/actions/workflows/ci.yml) [](#license) [](https://nodejs.org) [](https://github.com/sponsors/rgfaber)
A Model Context Protocol server that exposes the Macula mesh to any agent harness that speaks MCP. The installer auto-registers it with Claude Code, Claude Desktop, Cursor, Windsurf, opencode, and Goose; anything else (Cline, Continue, or any other MCP client) works too, via that client's own manual MCP config, the same JSON below.
// .mcp.json (or your harness's MCP config)
{
"mcpServers": {
"macula": { "command": "macula-mcp" },
},
}Before you install: this isn't a standalone tool. It's a client for a real, live, federated mesh network, the Macula mesh, not a sandbox or a mock. Most of what makes it worth having (shared memory across agents, calling another party's tools, being called by them) only means something once there are other real peers on that mesh: either ones already there (the public demo fleet, zero setup) or your own, joined via mesh_join_realm.
That said, you don't need any of that to confirm it's actually working. Once installed, ask your agent to call mesh_call with procedure mcl-echo/echo and args {"message": "hello"}: it reaches a real, always-on service over the real public fleet by direct dial and echoes back what you s
f202f07b4931OBSERVED · 2026-10-11Connect
Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control.
claude mcp add mcp -- npx -y @macula-io/[email protected]
Exposed tools (42)
37 read · 5 write · 0 destructive.
| Tool | Risk | Description |
|---|---|---|
help | write | Quick-start help for the Macula mesh tools in this conversation -- overview, examples, gotchas. |
help_conversations | read | Explain rooms and central -- mesh_open_room/mesh_join_room/mesh_say/mesh_read_inbox/mesh_leave_room/mesh_rooms -- and the envelope every message carries. |
help_identity | write | Explain how mesh identity works in this conversation: one post-quantum key per session. |
help_install | write | Explain how to install macula-mcp, register it, and verify it |
help_presence | read | Explain mesh_hello/mesh_agents/mesh_goodbye/mesh_read_inbox -- what presence is for, how it persists, and why it |
help_serve | read | Explain mesh_serve/mesh_unserve -- what serving actually exposes and the risk to weigh before using it. |
help_watch | read | Explain what mesh_watch is actually good for and the mistake to avoid with it. |
help_wire_format | read | Explain the Macula wire-format rules (no booleans, naming conventions) with examples. |
mesh_agents | read | |
mesh_answer_ring | read | |
mesh_call | read | |
mesh_find_record | read | |
mesh_find_records | read | |
mesh_find_records_by_type | read | |
mesh_get | read | |
mesh_goodbye | read | |
mesh_hello | read | |
mesh_join_realm | read | |
mesh_join_room | read | |
mesh_leave_room | read | |
mesh_list_realms | read | |
mesh_list_stations | read | |
mesh_lobby_transcript | read | |
mesh_observe_lobby | read | |
mesh_open_room | read | |
mesh_publish | write | |
mesh_put | write | |
mesh_read_inbox | read | |
mesh_recall | read | |
mesh_remember | read | |
mesh_remember_directory | read | |
mesh_ring | read | |
mesh_rooms | read | |
mesh_say | read | |
mesh_serve | read | |
mesh_trust_agent | read | |
mesh_unobserve_lobby | read | |
mesh_unserve | read | |
mesh_untrust_agent | read | |
mesh_wait_ring | read | |
mesh_wait_room | read | |
mesh_watch | read |
Trust audit
BLOCKgrade D · trust 69/100 Do not install this without reading the findings. The audit found something that could harm you or your machine.
| Layer | What it checks | Result |
|---|---|---|
| L0 | Provenance & inventory | PASS |
| L1 | Static analysis of the code | FAIL |
| L2 | Instruction surface (what it tells the agent) | PASS |
| L3 | Class-specific surface | PASS |
| L4 | Behavioural (sandbox) | SKIPPED |
What the source does
- Filesystem
- declared (1 observation(s))
- Network
- declared (1 observation(s))
- Shell
- none-observed
- Dependencies
- not all pinned
- Secrets in source
- found
Findings (10)
skipped.push({ path: rel, reason: "filename matches a known secret-bearing convention (.env/.pem/.key/id_rsa/.ssh/.aws/.npmrc/credentials.json) -- refusing to read it at all" });"1a6b9042fec6f6d17ae36139ff5598b268ab03a77187d28e0e2af9dec071fc554bbcf4c79dbaa4e9761496e2efeaab34eabae67e975735684a6a6dc355235701730f17de29c3e5f95bfa082dbaad6312014ff318bfb351bafe8dd06ddd2354f197e4d38
const PRIVATE_KEY_PEM = `-----BEGIN RSA PRIVATE KEY-----
const m = findLikelySecret("-----BEGIN OPENSSH PRIVATE KEY-----\nfakekeydata\n-----END OPENSSH PRIVATE KEY-----", "content");const m = findLikelySecret("xoxb-1234567890-abcdefghij", "text");"eyJpc3MiOiIwNzljZjFlNTQxMmI1ZTIyNzc5M2JjYzk0YmRjNGExNjJhZDM2YzEwYzZmODYxMjc2ZmJiMjE0MDIxOWNhN2YxIiwiYXVkIjoiMTgyYzczMjBkZWQzY2U1ZjRiYTU0ZmFmNjhlYWNjN2IyZTA0NzZhYTNhMDE0OGRkMzNlOTk2Y2IzYzY3NmUwOSIsImV
"signature_base64": "o2NrZXlZCiBbRdcB5j9R6Nd0934hvF9gDL5KiPmGSEeF592U5ghvI1eNBzPEqWGGXSnXLTg+rO3kLSK9mmft5Wjq4bMbskYpPDngEfQeaqgGYMd8l9si1swGzP5DZrMHgfbM08A11wjhuJP6RRA36x6ykWaJ0sDLWuI3XANYK4Vkb6yvb6O
"signature_base64": "o2NrZXlZDC6Sy3yeQ6pASRyz/u9AkXIPeP6CZVyw84yyx7I0s7PQMM3vpdMdEVDiw9OLHsfzQ3eCMD1ojV06JXxQaKol5bgQibBY2XKWdUL47VTxi7Os8D22lY6Ckn5BzYs03chsBBcAlehytb4NTbtqPSCdGov5UIqe9y5Ww3dv7IRsFP7
const homograph = "io.mаcula"; // Cyrillic а (U+0430), not Latin a
@macula-io/ts, @modelcontextprotocol/sdk, qrcode, yaml, zod, @types/node, @types/qrcode, typescript
Gates applied: no_behavioural_pass.
f202f07b4931full audit observations/trust-audit/mcp-server/macula-io__macula-mcp.json · Report an issue / request a re-scanAudit history
Every audit this server has had. A grade with a past is a grade somebody is still checking.
| Date | Source | Verdict | Grade | Score | Change |
|---|---|---|---|---|---|
| 2026-10-11 | f202f07b4931 | BLOCK | D | 69 | first audit |
Questions
What is the @macula-io/mcp MCP server?
MCP server that gives Claude Code, Cursor, opencode and any agent harness shared memory, identity and messaging over the Macula mesh
What tools does @macula-io/mcp expose?
42 in total: 37 read-only, 5 that write, and 0 that can delete or overwrite. Every one is listed on this page with its risk.
Is @macula-io/mcp safe to connect to an agent?
No — not without reading the findings first. The audit graded it D (69/100) and found 1 critical or high issue in the source. Each one is listed on this page with the file and line it is on.
What credentials does @macula-io/mcp need?
No credential environment variables were found in its source, so it appears to need none.
How does @macula-io/mcp run?
It speaks stdio and streamable-http, so it runs as a local process your client starts. It is published on npm as @macula-io/mcp at 0.46.1.
How current is this page?
The grade is for one exact copy of the source (f202f07b4931), read on 2026-10-11. The repository is watched and re-audited when it changes.