Agents (MCP)
Neurowire ships an MCP server, @neurowire/mcp, so an LLM agent can read feeds, follow journals, and verify taps directly. Results default to NWF, the most compact format, which keeps an agent's context small.
Claude Code plugin
The plugin bundles the server and two skills (following feeds, authoring a tap), so one install gives an agent both the tools and the know-how:
bash
/plugin marketplace add starside-io/claude-plugins
/plugin install neurowire@starsideAny MCP client
The server speaks stdio. Point your client at:
bash
npx -y @neurowire/mcpFor Claude Code without the plugin:
bash
claude mcp add neurowire -- npx -y @neurowire/mcpFor a client configured with JSON (Claude Desktop, Cursor, and similar):
json
{
"mcpServers": {
"neurowire": {
"command": "npx",
"args": ["-y", "@neurowire/mcp"],
"env": { "NEUROWIRE_MCP_ALLOW": "github.com,simonwillison.net,claude.com" }
}
}
}Configuration
| Variable | Default | Purpose |
|---|---|---|
NEUROWIRE_MCP_ALLOW | (unset) | Comma separated hosts that caller-supplied URLs may fetch. Unset allows every host. |
NEUROWIRE_MESHES | (unset) | Extra mesh directories, searched before ~/.config/neurowire/meshes. |
NEUROWIRE_CONSTRUCTS | (unset) | Extra construct directories, searched before ~/.config/neurowire/constructs. |
NEUROWIRE_JOURNAL | ~/.config/neurowire/journal | Where the journal tools read from. |
NEUROWIRE_TAPS | (unset) | Extra tap files or directories, as for the CLI. |
What an agent can do
- Answer "what shipped this week?" with
fetch_meshon the bundledai-newsmesh, orquerywithsince: "7d". - Follow an archive over time. Keep a journal fresh with the CLI (
neurowire --mesh ai-news.json --journal ai --watch), then have the agent callwhats_newand store the cursor it returns. The next call yields exactly what arrived. - Read a site with no feed.
propose_tapdrafts a tap andverify_tapgates it. The agent can iterate on selectors, but only a passing template counts, and nothing is installed. See Taps. - Answer questions about Neurowire itself with
search_docs, which reads the publishedllms.txtindex.
The full tool list, input fields, and result conventions are in the @neurowire/mcp reference.
Docs for agents
The docs site publishes a flattened, token-efficient copy of itself for any agent, MCP or not:
/llms.txt: the table of contents./llms-full.txt: every page in one file.