coherence-mcp-server 0.4.1 → 0.4.3

package/README.md

@@ -2,7 +2,7 @@
 
 **Give your AI agent native access to every idea, spec, contributor, and value chain in the Coherence Network.**
 
-An [MCP](https://modelcontextprotocol.io/) (Model Context Protocol) server that exposes the full Coherence Network API as 51 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 evolve the project graph without writing a single API call.
+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.
 
 ```bash
 npx coherence-mcp-server
@@ -25,6 +25,8 @@ This MCP server changes that. It gives any agent a typed interface to:
 - **Evolve** — create new ideas, link dependencies, and navigate the universal graph
 - **Finance** — track treasury balances, record deposits, and monitor assets
 - **Signal** — ingest news, track trending keywords, and measure concept resonance
+- **Peers** — discover resonant contributors by shared interests or proximity
+- **Blueprint** — apply standardized project roadmaps (templates) to instantly seed work
 - **Ontology** — explore the Living Codex (184 universal concepts, 53 axes)
 - **Govern** — propose changes, vote on requests, and monitor network health
 
@@ -73,7 +75,7 @@ Point your MCP client at `npx coherence-mcp-server` via stdio transport.
 
 ---
 
-## Tools (51)
+## Tools (56)
 
 ### Ideas — the portfolio engine
 
@@ -93,7 +95,7 @@ Point your MCP client at `npx coherence-mcp-server` via stdio transport.
 | Tool | What it does |
 |------|-------------|
 | `coherence_list_specs` | Specs with ROI metrics and value gaps. Searchable. |
-| `coherence_get_spec` | Full spec: summary, implementation plan, pseudocode, estimated ROI. |
+| `coherence_get_spec" | Full spec: summary, implementation plan, pseudocode, estimated ROI. |
 
 ### Value lineage — end-to-end traceability
 
@@ -138,6 +140,20 @@ Point your MCP client at `npx coherence-mcp-server` via stdio transport.
 | `coherence_get_entity_edges` | Incoming and outgoing edges for any entity. |
 | `coherence_create_edge` | Create a typed edge between two entities. |
 
+### Peers — contributor discovery
+
+| Tool | What it does |
+|------|-------------|
+| `coherence_get_resonant_peers` | Discover contributors with similar interests. |
+| `coherence_get_nearby_peers` | Find contributors physically close to you. |
+
+### Blueprints — project templates
+
+| Tool | What it does |
+|------|-------------|
+| `coherence_list_blueprints` | List available project roadmap templates. |
+| `coherence_apply_blueprint` | Seed a full roadmap of ideas and edges from a template. |
+
 ### Assets — tracked artifacts
 
 | Tool | What it does |
@@ -195,7 +211,7 @@ Point your MCP client at `npx coherence-mcp-server` via stdio transport.
 
 ## CLI equivalent
 
-The Coherence CLI (`npm i -g coherence-cli`) provides the same capabilities as the MCP tools. Run `cc help` for the full list of 54 commands.
+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.
 
 ---
 
@@ -206,9 +222,8 @@ Once connected, you can ask your agent things like:
 - *"What ideas have the highest ROI right now?"*
 - *"Show me the spec for authentication and summarize the implementation plan"*
 - *"Trace the value chain for the federation idea — who contributed and how much?"*
-- *"What are the trending keywords in the news today and which ideas do they resonate with?"*
-- *"Link my GitHub identity and record a code contribution for the CLI work I did"*
-- *"What's the network friction report for the last 30 days?"*
+- *"Who are the resonant peers I should collaborate with based on my interests?"*
+- *"Apply the Python API blueprint to seed our new backend service"*
 - *"Pick the next best idea for me to work on"*
 - *"Create a new idea for 'Automated PR reviews' and link it as enabling the 'GitHub integration' idea"*
 
@@ -234,7 +249,7 @@ Every part of the network links to every other. Jump in wherever makes sense.
 | **Web** | Browse ideas, specs, and contributors visually | [coherencycoin.com](https://coherencycoin.com) |
 | **API** | 100+ endpoints, full OpenAPI docs, the engine behind everything | [api.coherencycoin.com/docs](https://api.coherencycoin.com/docs) |
 | **CLI** | Terminal-first access — `npm i -g coherence-cli` then `cc help` | [npm: coherence-cli](https://www.npmjs.com/package/coherence-cli) |
-| **MCP Server** | This package — 51 typed tools for AI agents | [npm: coherence-mcp-server](https://www.npmjs.com/package/coherence-mcp-server) |
+| **MCP Server** | This package — 56 typed tools for AI agents | [npm: coherence-mcp-server](https://www.npmjs.com/package/coherence-mcp-server) |
 | **OpenClaw Skill** | Auto-triggers in any OpenClaw instance for ideas, specs, coherence | [ClawHub: coherence-network](https://clawhub.com/skills/coherence-network) |
 | **GitHub** | Source code, specs, issues, and contribution tracking | [github.com/seeker71/Coherence-Network](https://github.com/seeker71/Coherence-Network) |
 

package/README.template.md

@@ -2,7 +2,7 @@
 
 **Give your AI agent native access to every idea, spec, contributor, and value chain in the Coherence Network.**
 
-An [MCP](https://modelcontextprotocol.io/) (Model Context Protocol) server that exposes the full Coherence Network API as 51 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 evolve the project graph without writing a single API call.
+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.
 
 ```bash
 npx coherence-mcp-server
@@ -25,6 +25,8 @@ This MCP server changes that. It gives any agent a typed interface to:
 - **Evolve** — create new ideas, link dependencies, and navigate the universal graph
 - **Finance** — track treasury balances, record deposits, and monitor assets
 - **Signal** — ingest news, track trending keywords, and measure concept resonance
+- **Peers** — discover resonant contributors by shared interests or proximity
+- **Blueprint** — apply standardized project roadmaps (templates) to instantly seed work
 - **Ontology** — explore the Living Codex (184 universal concepts, 53 axes)
 - **Govern** — propose changes, vote on requests, and monitor network health
 
@@ -73,7 +75,7 @@ Point your MCP client at `npx coherence-mcp-server` via stdio transport.
 
 ---
 
-## Tools (51)
+## Tools (56)
 
 ### Ideas — the portfolio engine
 
@@ -93,7 +95,7 @@ Point your MCP client at `npx coherence-mcp-server` via stdio transport.
 | Tool | What it does |
 |------|-------------|
 | `coherence_list_specs` | Specs with ROI metrics and value gaps. Searchable. |
-| `coherence_get_spec` | Full spec: summary, implementation plan, pseudocode, estimated ROI. |
+| `coherence_get_spec" | Full spec: summary, implementation plan, pseudocode, estimated ROI. |
 
 ### Value lineage — end-to-end traceability
 
@@ -138,6 +140,20 @@ Point your MCP client at `npx coherence-mcp-server` via stdio transport.
 | `coherence_get_entity_edges` | Incoming and outgoing edges for any entity. |
 | `coherence_create_edge` | Create a typed edge between two entities. |
 
+### Peers — contributor discovery
+
+| Tool | What it does |
+|------|-------------|
+| `coherence_get_resonant_peers` | Discover contributors with similar interests. |
+| `coherence_get_nearby_peers` | Find contributors physically close to you. |
+
+### Blueprints — project templates
+
+| Tool | What it does |
+|------|-------------|
+| `coherence_list_blueprints` | List available project roadmap templates. |
+| `coherence_apply_blueprint` | Seed a full roadmap of ideas and edges from a template. |
+
 ### Assets — tracked artifacts
 
 | Tool | What it does |
@@ -195,7 +211,7 @@ Point your MCP client at `npx coherence-mcp-server` via stdio transport.
 
 ## CLI equivalent
 
-The Coherence CLI (`npm i -g coherence-cli`) provides the same capabilities as the MCP tools. Run `cc help` for the full list of 54 commands.
+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.
 
 ---
 
@@ -206,9 +222,8 @@ Once connected, you can ask your agent things like:
 - *"What ideas have the highest ROI right now?"*
 - *"Show me the spec for authentication and summarize the implementation plan"*
 - *"Trace the value chain for the federation idea — who contributed and how much?"*
-- *"What are the trending keywords in the news today and which ideas do they resonate with?"*
-- *"Link my GitHub identity and record a code contribution for the CLI work I did"*
-- *"What's the network friction report for the last 30 days?"*
+- *"Who are the resonant peers I should collaborate with based on my interests?"*
+- *"Apply the Python API blueprint to seed our new backend service"*
 - *"Pick the next best idea for me to work on"*
 - *"Create a new idea for 'Automated PR reviews' and link it as enabling the 'GitHub integration' idea"*
 
@@ -234,7 +249,7 @@ Every part of the network links to every other. Jump in wherever makes sense.
 | **Web** | Browse ideas, specs, and contributors visually | [coherencycoin.com](https://coherencycoin.com) |
 | **API** | 100+ endpoints, full OpenAPI docs, the engine behind everything | [api.coherencycoin.com/docs](https://api.coherencycoin.com/docs) |
 | **CLI** | Terminal-first access — `npm i -g coherence-cli` then `cc help` | [npm: coherence-cli](https://www.npmjs.com/package/coherence-cli) |
-| **MCP Server** | This package — 51 typed tools for AI agents | [npm: coherence-mcp-server](https://www.npmjs.com/package/coherence-mcp-server) |
+| **MCP Server** | This package — 56 typed tools for AI agents | [npm: coherence-mcp-server](https://www.npmjs.com/package/coherence-mcp-server) |
 | **OpenClaw Skill** | Auto-triggers in any OpenClaw instance for ideas, specs, coherence | [ClawHub: coherence-network](https://clawhub.com/skills/coherence-network) |
 | **GitHub** | Source code, specs, issues, and contribution tracking | [github.com/seeker71/Coherence-Network](https://github.com/seeker71/Coherence-Network) |
 

package/coherence_mcp_server/server.py

@@ -619,6 +619,50 @@ TOOLS: list[Tool] = [
             },
         },
     ),
+    # Peers (Contributor Discovery)
+    Tool(
+        name="coherence_get_resonant_peers",
+        description="Find contributors with similar interests (structural resonance) to a specific contributor.",
+        inputSchema={
+            "type": "object",
+            "required": ["contributor_id"],
+            "properties": {
+                "contributor_id": {"type": "string"},
+                "limit": {"type": "number", "default": 20},
+            },
+        },
+    ),
+    Tool(
+        name="coherence_get_nearby_peers",
+        description="Find contributors physically close to a specific contributor.",
+        inputSchema={
+            "type": "object",
+            "required": ["contributor_id"],
+            "properties": {
+                "contributor_id": {"type": "string"},
+                "radius_km": {"type": "number", "default": 100.0},
+                "limit": {"type": "number", "default": 20},
+            },
+        },
+    ),
+    # Blueprints (Project Templates)
+    Tool(
+        name="coherence_list_blueprints",
+        description="List available project roadmap blueprints (templates).",
+        inputSchema={"type": "object", "properties": {}},
+    ),
+    Tool(
+        name="coherence_apply_blueprint",
+        description="Seed a full roadmap of ideas and edges from a blueprint template.",
+        inputSchema={
+            "type": "object",
+            "required": ["blueprint_id"],
+            "properties": {
+                "blueprint_id": {"type": "string"},
+                "prefix": {"type": "string", "description": "Optional ID prefix for created ideas"},
+            },
+        },
+    ),
     # Concepts (Living Codex ontology)
     Tool(
         name="coherence_list_concepts",
@@ -910,6 +954,20 @@ def dispatch(name: str, args: dict[str, Any]) -> Any:
             return api_get("/api/dif/stats")
         case "coherence_get_recent_dif":
             return api_get("/api/dif/recent", {"limit": args.get("limit", 20)})
+        # Peers
+        case "coherence_get_resonant_peers":
+            return api_get("/api/peers/resonant", {"contributor_id": args["contributor_id"], "limit": args.get("limit", 20)})
+        case "coherence_get_nearby_peers":
+            return api_get("/api/peers/nearby", {
+                "contributor_id": args["contributor_id"],
+                "radius_km": args.get("radius_km", 100.0),
+                "limit": args.get("limit", 20)
+            })
+        # Blueprints
+        case "coherence_list_blueprints":
+            return api_get("/api/blueprints")
+        case "coherence_apply_blueprint":
+            return api_post(f"/api/blueprints/{args['blueprint_id']}/apply", {"prefix": args.get("prefix", "")})
         # Concepts
         case "coherence_list_concepts":
             if args.get("search"):

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "coherence-mcp-server",
-  "version": "0.4.1",
+  "version": "0.4.3",
   "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.",
   "type": "module",
   "bin": {