coherence-mcp-server 0.4.3 → 0.4.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/README.md +11 -4
  2. package/README.template.md +11 -4
  3. package/coherence_mcp_server/server.py +13 -0
  4. package/package.json +1 -1
package/README.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  **Give your AI agent native access to every idea, spec, contributor, and value chain in the Coherence Network.**
4
4
 
5
- An [MCP](https://modelcontextprotocol.io/) (Model Context Protocol) server that exposes the full Coherence Network API as 56 typed tools — so Claude, Cursor, Windsurf, or any MCP-compatible agent can browse ideas, look up specs, trace value lineage, link identities, record contributions, execute tasks, discover resonant peers, and apply project blueprints without writing a single API call.
5
+ An [MCP](https://modelcontextprotocol.io/) (Model Context Protocol) server that exposes the full Coherence Network API as 57 typed tools — so Claude, Cursor, Windsurf, or any MCP-compatible agent can browse ideas, look up specs, trace value lineage, link identities, record contributions, execute tasks, discover resonant peers, apply project blueprints, and read repository content via direct links without writing a single API call.
6
6
 
7
7
  ```bash
8
8
  npx coherence-mcp-server
@@ -27,6 +27,7 @@ This MCP server changes that. It gives any agent a typed interface to:
27
27
  - **Signal** — ingest news, track trending keywords, and measure concept resonance
28
28
  - **Peers** — discover resonant contributors by shared interests or proximity
29
29
  - **Blueprint** — apply standardized project roadmaps (templates) to instantly seed work
30
+ - **Direct Access** — read specs and documentation via direct repository links
30
31
  - **Ontology** — explore the Living Codex (184 universal concepts, 53 axes)
31
32
  - **Govern** — propose changes, vote on requests, and monitor network health
32
33
 
@@ -75,7 +76,7 @@ Point your MCP client at `npx coherence-mcp-server` via stdio transport.
75
76
 
76
77
  ---
77
78
 
78
- ## Tools (56)
79
+ ## Tools (57)
79
80
 
80
81
  ### Ideas — the portfolio engine
81
82
 
@@ -95,7 +96,7 @@ Point your MCP client at `npx coherence-mcp-server` via stdio transport.
95
96
  | Tool | What it does |
96
97
  |------|-------------|
97
98
  | `coherence_list_specs` | Specs with ROI metrics and value gaps. Searchable. |
98
- | `coherence_get_spec" | Full spec: summary, implementation plan, pseudocode, estimated ROI. |
99
+ | `coherence_get_spec` | Full spec: summary, implementation plan, pseudocode, estimated ROI. |
99
100
 
100
101
  ### Value lineage — end-to-end traceability
101
102
 
@@ -154,6 +155,12 @@ Point your MCP client at `npx coherence-mcp-server` via stdio transport.
154
155
  | `coherence_list_blueprints` | List available project roadmap templates. |
155
156
  | `coherence_apply_blueprint` | Seed a full roadmap of ideas and edges from a template. |
156
157
 
158
+ ### Repository Content — direct access
159
+
160
+ | Tool | What it does |
161
+ |------|-------------|
162
+ | `coherence_read_file` | Read raw file content (specs, docs) via direct link. |
163
+
157
164
  ### Assets — tracked artifacts
158
165
 
159
166
  | Tool | What it does |
@@ -249,7 +256,7 @@ Every part of the network links to every other. Jump in wherever makes sense.
249
256
  | **Web** | Browse ideas, specs, and contributors visually | [coherencycoin.com](https://coherencycoin.com) |
250
257
  | **API** | 100+ endpoints, full OpenAPI docs, the engine behind everything | [api.coherencycoin.com/docs](https://api.coherencycoin.com/docs) |
251
258
  | **CLI** | Terminal-first access — `npm i -g coherence-cli` then `cc help` | [npm: coherence-cli](https://www.npmjs.com/package/coherence-cli) |
252
- | **MCP Server** | This package — 56 typed tools for AI agents | [npm: coherence-mcp-server](https://www.npmjs.com/package/coherence-mcp-server) |
259
+ | **MCP Server** | This package — 57 typed tools for AI agents | [npm: coherence-mcp-server](https://www.npmjs.com/package/coherence-mcp-server) |
253
260
  | **OpenClaw Skill** | Auto-triggers in any OpenClaw instance for ideas, specs, coherence | [ClawHub: coherence-network](https://clawhub.com/skills/coherence-network) |
254
261
  | **GitHub** | Source code, specs, issues, and contribution tracking | [github.com/seeker71/Coherence-Network](https://github.com/seeker71/Coherence-Network) |
255
262
 
package/README.template.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  **Give your AI agent native access to every idea, spec, contributor, and value chain in the Coherence Network.**
4
4
 
5
- An [MCP](https://modelcontextprotocol.io/) (Model Context Protocol) server that exposes the full Coherence Network API as 56 typed tools — so Claude, Cursor, Windsurf, or any MCP-compatible agent can browse ideas, look up specs, trace value lineage, link identities, record contributions, execute tasks, discover resonant peers, and apply project blueprints without writing a single API call.
5
+ An [MCP](https://modelcontextprotocol.io/) (Model Context Protocol) server that exposes the full Coherence Network API as 57 typed tools — so Claude, Cursor, Windsurf, or any MCP-compatible agent can browse ideas, look up specs, trace value lineage, link identities, record contributions, execute tasks, discover resonant peers, apply project blueprints, and read repository content via direct links without writing a single API call.
6
6
 
7
7
  ```bash
8
8
  npx coherence-mcp-server
@@ -27,6 +27,7 @@ This MCP server changes that. It gives any agent a typed interface to:
27
27
  - **Signal** — ingest news, track trending keywords, and measure concept resonance
28
28
  - **Peers** — discover resonant contributors by shared interests or proximity
29
29
  - **Blueprint** — apply standardized project roadmaps (templates) to instantly seed work
30
+ - **Direct Access** — read specs and documentation via direct repository links
30
31
  - **Ontology** — explore the Living Codex (184 universal concepts, 53 axes)
31
32
  - **Govern** — propose changes, vote on requests, and monitor network health
32
33
 
@@ -75,7 +76,7 @@ Point your MCP client at `npx coherence-mcp-server` via stdio transport.
75
76
 
76
77
  ---
77
78
 
78
- ## Tools (56)
79
+ ## Tools (57)
79
80
 
80
81
  ### Ideas — the portfolio engine
81
82
 
@@ -95,7 +96,7 @@ Point your MCP client at `npx coherence-mcp-server` via stdio transport.
95
96
  | Tool | What it does |
96
97
  |------|-------------|
97
98
  | `coherence_list_specs` | Specs with ROI metrics and value gaps. Searchable. |
98
- | `coherence_get_spec" | Full spec: summary, implementation plan, pseudocode, estimated ROI. |
99
+ | `coherence_get_spec` | Full spec: summary, implementation plan, pseudocode, estimated ROI. |
99
100
 
100
101
  ### Value lineage — end-to-end traceability
101
102
 
@@ -154,6 +155,12 @@ Point your MCP client at `npx coherence-mcp-server` via stdio transport.
154
155
  | `coherence_list_blueprints` | List available project roadmap templates. |
155
156
  | `coherence_apply_blueprint` | Seed a full roadmap of ideas and edges from a template. |
156
157
 
158
+ ### Repository Content — direct access
159
+
160
+ | Tool | What it does |
161
+ |------|-------------|
162
+ | `coherence_read_file` | Read raw file content (specs, docs) via direct link. |
163
+
157
164
  ### Assets — tracked artifacts
158
165
 
159
166
  | Tool | What it does |
@@ -249,7 +256,7 @@ Every part of the network links to every other. Jump in wherever makes sense.
249
256
  | **Web** | Browse ideas, specs, and contributors visually | [coherencycoin.com](https://coherencycoin.com) |
250
257
  | **API** | 100+ endpoints, full OpenAPI docs, the engine behind everything | [api.coherencycoin.com/docs](https://api.coherencycoin.com/docs) |
251
258
  | **CLI** | Terminal-first access — `npm i -g coherence-cli` then `cc help` | [npm: coherence-cli](https://www.npmjs.com/package/coherence-cli) |
252
- | **MCP Server** | This package — 56 typed tools for AI agents | [npm: coherence-mcp-server](https://www.npmjs.com/package/coherence-mcp-server) |
259
+ | **MCP Server** | This package — 57 typed tools for AI agents | [npm: coherence-mcp-server](https://www.npmjs.com/package/coherence-mcp-server) |
253
260
  | **OpenClaw Skill** | Auto-triggers in any OpenClaw instance for ideas, specs, coherence | [ClawHub: coherence-network](https://clawhub.com/skills/coherence-network) |
254
261
  | **GitHub** | Source code, specs, issues, and contribution tracking | [github.com/seeker71/Coherence-Network](https://github.com/seeker71/Coherence-Network) |
255
262
 
package/coherence_mcp_server/server.py CHANGED
@@ -663,6 +663,17 @@ TOOLS: list[Tool] = [
663
663
  },
664
664
  },
665
665
  ),
666
+ Tool(
667
+ name="coherence_read_file",
668
+ description="Read raw file content from the repository (specs, docs, etc.) via direct link.",
669
+ inputSchema={
670
+ "type": "object",
671
+ "required": ["path"],
672
+ "properties": {
673
+ "path": {"type": "string", "description": "Relative path from repo root (e.g. 'specs/169-procedural-memory.md')"},
674
+ },
675
+ },
676
+ ),
666
677
  # Concepts (Living Codex ontology)
667
678
  Tool(
668
679
  name="coherence_list_concepts",
@@ -968,6 +979,8 @@ def dispatch(name: str, args: dict[str, Any]) -> Any:
968
979
  return api_get("/api/blueprints")
969
980
  case "coherence_apply_blueprint":
970
981
  return api_post(f"/api/blueprints/{args['blueprint_id']}/apply", {"prefix": args.get("prefix", "")})
982
+ case "coherence_read_file":
983
+ return api_get("/api/content/file", {"path": args["path"]})
971
984
  # Concepts
972
985
  case "coherence_list_concepts":
973
986
  if args.get("search"):
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "coherence-mcp-server",
3
- "version": "0.4.3",
3
+ "version": "0.4.5",
4
4
  "description": "Unified MCP server for the Coherence Network — 51 typed tools for AI agents to browse ideas, manage tasks, link identities, and navigate the universal graph.",
5
5
  "type": "module",
6
6
  "bin": {