coherence-mcp-server 0.4.2 → 0.4.4

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 +16 -8
  2. package/README.template.md +16 -8
  3. package/coherence_mcp_server/server.py +23 -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 54 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, and discover resonant peers without writing a single API call.
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.
6
6
 
7
7
  ```bash
8
8
  npx coherence-mcp-server
@@ -26,6 +26,7 @@ This MCP server changes that. It gives any agent a typed interface to:
26
26
  - **Finance** — track treasury balances, record deposits, and monitor assets
27
27
  - **Signal** — ingest news, track trending keywords, and measure concept resonance
28
28
  - **Peers** — discover resonant contributors by shared interests or proximity
29
+ - **Blueprint** — apply standardized project roadmaps (templates) to instantly seed work
29
30
  - **Ontology** — explore the Living Codex (184 universal concepts, 53 axes)
30
31
  - **Govern** — propose changes, vote on requests, and monitor network health
31
32
 
@@ -74,7 +75,7 @@ Point your MCP client at `npx coherence-mcp-server` via stdio transport.
74
75
 
75
76
  ---
76
77
 
77
- ## Tools (54)
78
+ ## Tools (56)
78
79
 
79
80
  ### Ideas — the portfolio engine
80
81
 
@@ -94,7 +95,7 @@ Point your MCP client at `npx coherence-mcp-server` via stdio transport.
94
95
  | Tool | What it does |
95
96
  |------|-------------|
96
97
  | `coherence_list_specs` | Specs with ROI metrics and value gaps. Searchable. |
97
- | `coherence_get_spec` | Full spec: summary, implementation plan, pseudocode, estimated ROI. |
98
+ | `coherence_get_spec" | Full spec: summary, implementation plan, pseudocode, estimated ROI. |
98
99
 
99
100
  ### Value lineage — end-to-end traceability
100
101
 
@@ -146,6 +147,13 @@ Point your MCP client at `npx coherence-mcp-server` via stdio transport.
146
147
  | `coherence_get_resonant_peers` | Discover contributors with similar interests. |
147
148
  | `coherence_get_nearby_peers` | Find contributors physically close to you. |
148
149
 
150
+ ### Blueprints — project templates
151
+
152
+ | Tool | What it does |
153
+ |------|-------------|
154
+ | `coherence_list_blueprints` | List available project roadmap templates. |
155
+ | `coherence_apply_blueprint` | Seed a full roadmap of ideas and edges from a template. |
156
+
149
157
  ### Assets — tracked artifacts
150
158
 
151
159
  | Tool | What it does |
@@ -178,8 +186,8 @@ Point your MCP client at `npx coherence-mcp-server` via stdio transport.
178
186
  |------|-------------|
179
187
  | `coherence_list_change_requests` | Open governance proposals. |
180
188
  | `coherence_get_change_request` | Detail for a specific proposal. |
181
- | `coherence_vote_governance" | Cast a 'yes' or 'no' vote on a proposal. |
182
- | `coherence_propose_governance" | Create a new governance change request. |
189
+ | `coherence_vote_governance` | Cast a 'yes' or 'no' vote on a proposal. |
190
+ | `coherence_propose_governance` | Create a new governance change request. |
183
191
 
184
192
  ### Living Codex ontology
185
193
 
@@ -203,7 +211,7 @@ Point your MCP client at `npx coherence-mcp-server` via stdio transport.
203
211
 
204
212
  ## CLI equivalent
205
213
 
206
- The Coherence CLI (`npm i -g coherence-cli`) provides the same capabilities as the MCP tools. Run `cc help` for the full list of 56 commands.
214
+ The Coherence CLI (`npm i -g coherence-cli`) provides the same capabilities as the MCP tools. Run `cc help` for the full list of 58 commands.
207
215
 
208
216
  ---
209
217
 
@@ -215,7 +223,7 @@ Once connected, you can ask your agent things like:
215
223
  - *"Show me the spec for authentication and summarize the implementation plan"*
216
224
  - *"Trace the value chain for the federation idea — who contributed and how much?"*
217
225
  - *"Who are the resonant peers I should collaborate with based on my interests?"*
218
- - *"What's the network friction report for the last 30 days?"*
226
+ - *"Apply the Python API blueprint to seed our new backend service"*
219
227
  - *"Pick the next best idea for me to work on"*
220
228
  - *"Create a new idea for 'Automated PR reviews' and link it as enabling the 'GitHub integration' idea"*
221
229
 
@@ -241,7 +249,7 @@ Every part of the network links to every other. Jump in wherever makes sense.
241
249
  | **Web** | Browse ideas, specs, and contributors visually | [coherencycoin.com](https://coherencycoin.com) |
242
250
  | **API** | 100+ endpoints, full OpenAPI docs, the engine behind everything | [api.coherencycoin.com/docs](https://api.coherencycoin.com/docs) |
243
251
  | **CLI** | Terminal-first access — `npm i -g coherence-cli` then `cc help` | [npm: coherence-cli](https://www.npmjs.com/package/coherence-cli) |
244
- | **MCP Server** | This package — 54 typed tools for AI agents | [npm: coherence-mcp-server](https://www.npmjs.com/package/coherence-mcp-server) |
252
+ | **MCP Server** | This package — 56 typed tools for AI agents | [npm: coherence-mcp-server](https://www.npmjs.com/package/coherence-mcp-server) |
245
253
  | **OpenClaw Skill** | Auto-triggers in any OpenClaw instance for ideas, specs, coherence | [ClawHub: coherence-network](https://clawhub.com/skills/coherence-network) |
246
254
  | **GitHub** | Source code, specs, issues, and contribution tracking | [github.com/seeker71/Coherence-Network](https://github.com/seeker71/Coherence-Network) |
247
255
 
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 54 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, and discover resonant peers without writing a single API call.
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.
6
6
 
7
7
  ```bash
8
8
  npx coherence-mcp-server
@@ -26,6 +26,7 @@ This MCP server changes that. It gives any agent a typed interface to:
26
26
  - **Finance** — track treasury balances, record deposits, and monitor assets
27
27
  - **Signal** — ingest news, track trending keywords, and measure concept resonance
28
28
  - **Peers** — discover resonant contributors by shared interests or proximity
29
+ - **Blueprint** — apply standardized project roadmaps (templates) to instantly seed work
29
30
  - **Ontology** — explore the Living Codex (184 universal concepts, 53 axes)
30
31
  - **Govern** — propose changes, vote on requests, and monitor network health
31
32
 
@@ -74,7 +75,7 @@ Point your MCP client at `npx coherence-mcp-server` via stdio transport.
74
75
 
75
76
  ---
76
77
 
77
- ## Tools (54)
78
+ ## Tools (56)
78
79
 
79
80
  ### Ideas — the portfolio engine
80
81
 
@@ -94,7 +95,7 @@ Point your MCP client at `npx coherence-mcp-server` via stdio transport.
94
95
  | Tool | What it does |
95
96
  |------|-------------|
96
97
  | `coherence_list_specs` | Specs with ROI metrics and value gaps. Searchable. |
97
- | `coherence_get_spec` | Full spec: summary, implementation plan, pseudocode, estimated ROI. |
98
+ | `coherence_get_spec" | Full spec: summary, implementation plan, pseudocode, estimated ROI. |
98
99
 
99
100
  ### Value lineage — end-to-end traceability
100
101
 
@@ -146,6 +147,13 @@ Point your MCP client at `npx coherence-mcp-server` via stdio transport.
146
147
  | `coherence_get_resonant_peers` | Discover contributors with similar interests. |
147
148
  | `coherence_get_nearby_peers` | Find contributors physically close to you. |
148
149
 
150
+ ### Blueprints — project templates
151
+
152
+ | Tool | What it does |
153
+ |------|-------------|
154
+ | `coherence_list_blueprints` | List available project roadmap templates. |
155
+ | `coherence_apply_blueprint` | Seed a full roadmap of ideas and edges from a template. |
156
+
149
157
  ### Assets — tracked artifacts
150
158
 
151
159
  | Tool | What it does |
@@ -178,8 +186,8 @@ Point your MCP client at `npx coherence-mcp-server` via stdio transport.
178
186
  |------|-------------|
179
187
  | `coherence_list_change_requests` | Open governance proposals. |
180
188
  | `coherence_get_change_request` | Detail for a specific proposal. |
181
- | `coherence_vote_governance" | Cast a 'yes' or 'no' vote on a proposal. |
182
- | `coherence_propose_governance" | Create a new governance change request. |
189
+ | `coherence_vote_governance` | Cast a 'yes' or 'no' vote on a proposal. |
190
+ | `coherence_propose_governance` | Create a new governance change request. |
183
191
 
184
192
  ### Living Codex ontology
185
193
 
@@ -203,7 +211,7 @@ Point your MCP client at `npx coherence-mcp-server` via stdio transport.
203
211
 
204
212
  ## CLI equivalent
205
213
 
206
- The Coherence CLI (`npm i -g coherence-cli`) provides the same capabilities as the MCP tools. Run `cc help` for the full list of 56 commands.
214
+ The Coherence CLI (`npm i -g coherence-cli`) provides the same capabilities as the MCP tools. Run `cc help` for the full list of 58 commands.
207
215
 
208
216
  ---
209
217
 
@@ -215,7 +223,7 @@ Once connected, you can ask your agent things like:
215
223
  - *"Show me the spec for authentication and summarize the implementation plan"*
216
224
  - *"Trace the value chain for the federation idea — who contributed and how much?"*
217
225
  - *"Who are the resonant peers I should collaborate with based on my interests?"*
218
- - *"What's the network friction report for the last 30 days?"*
226
+ - *"Apply the Python API blueprint to seed our new backend service"*
219
227
  - *"Pick the next best idea for me to work on"*
220
228
  - *"Create a new idea for 'Automated PR reviews' and link it as enabling the 'GitHub integration' idea"*
221
229
 
@@ -241,7 +249,7 @@ Every part of the network links to every other. Jump in wherever makes sense.
241
249
  | **Web** | Browse ideas, specs, and contributors visually | [coherencycoin.com](https://coherencycoin.com) |
242
250
  | **API** | 100+ endpoints, full OpenAPI docs, the engine behind everything | [api.coherencycoin.com/docs](https://api.coherencycoin.com/docs) |
243
251
  | **CLI** | Terminal-first access — `npm i -g coherence-cli` then `cc help` | [npm: coherence-cli](https://www.npmjs.com/package/coherence-cli) |
244
- | **MCP Server** | This package — 54 typed tools for AI agents | [npm: coherence-mcp-server](https://www.npmjs.com/package/coherence-mcp-server) |
252
+ | **MCP Server** | This package — 56 typed tools for AI agents | [npm: coherence-mcp-server](https://www.npmjs.com/package/coherence-mcp-server) |
245
253
  | **OpenClaw Skill** | Auto-triggers in any OpenClaw instance for ideas, specs, coherence | [ClawHub: coherence-network](https://clawhub.com/skills/coherence-network) |
246
254
  | **GitHub** | Source code, specs, issues, and contribution tracking | [github.com/seeker71/Coherence-Network](https://github.com/seeker71/Coherence-Network) |
247
255
 
package/coherence_mcp_server/server.py CHANGED
@@ -645,6 +645,24 @@ TOOLS: list[Tool] = [
645
645
  },
646
646
  },
647
647
  ),
648
+ # Blueprints (Project Templates)
649
+ Tool(
650
+ name="coherence_list_blueprints",
651
+ description="List available project roadmap blueprints (templates).",
652
+ inputSchema={"type": "object", "properties": {}},
653
+ ),
654
+ Tool(
655
+ name="coherence_apply_blueprint",
656
+ description="Seed a full roadmap of ideas and edges from a blueprint template.",
657
+ inputSchema={
658
+ "type": "object",
659
+ "required": ["blueprint_id"],
660
+ "properties": {
661
+ "blueprint_id": {"type": "string"},
662
+ "prefix": {"type": "string", "description": "Optional ID prefix for created ideas"},
663
+ },
664
+ },
665
+ ),
648
666
  # Concepts (Living Codex ontology)
649
667
  Tool(
650
668
  name="coherence_list_concepts",
@@ -945,6 +963,11 @@ def dispatch(name: str, args: dict[str, Any]) -> Any:
945
963
  "radius_km": args.get("radius_km", 100.0),
946
964
  "limit": args.get("limit", 20)
947
965
  })
966
+ # Blueprints
967
+ case "coherence_list_blueprints":
968
+ return api_get("/api/blueprints")
969
+ case "coherence_apply_blueprint":
970
+ return api_post(f"/api/blueprints/{args['blueprint_id']}/apply", {"prefix": args.get("prefix", "")})
948
971
  # Concepts
949
972
  case "coherence_list_concepts":
950
973
  if args.get("search"):
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "coherence-mcp-server",
3
- "version": "0.4.2",
3
+ "version": "0.4.4",
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": {