coherence-mcp-server 0.5.2 → 0.5.3

package/README.md

@@ -3,7 +3,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 89 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, receive the shared agent invitation, and read repository content via direct links without writing a single API call.
+An [MCP](https://modelcontextprotocol.io/) (Model Context Protocol) server that exposes the full Coherence Network API as 92 typed tools — so Claude, Cursor, Windsurf, or any MCP-compatible agent can browse ideas, look up specs, trace value lineage, link identities, record contributions, read field stories, execute tasks, discover resonant peers, apply project blueprints, receive the shared agent invitation, and read repository content via direct links without writing a single API call.
 
 ```bash
 npx coherence-mcp-server
@@ -78,7 +78,7 @@ Point your MCP client at `npx coherence-mcp-server` via stdio transport.
 
 ---
 
-## Tools (89)
+## Tools (92)
 
 ### Ideas — the portfolio engine
 
@@ -123,6 +123,14 @@ Point your MCP client at `npx coherence-mcp-server` via stdio transport.
 | `coherence_record_contribution` | Record work by contributor name or by provider identity (no registration needed). |
 | `coherence_contributor_ledger` | CC balance, contribution history, and linked ideas. |
 
+### Field Stories — contribution-derived profile memory
+
+| Tool | What it does |
+|------|-------------|
+| `coherence_get_field_story` | Read a published field story with canonical narrative, anchors, reports, and agent contribution surfaces. |
+| `coherence_get_field_story_artifact` | Read one artifact from a field story: anchors, summaries, reports, tools, or event traces. |
+| `coherence_contribute_field_story` | Record an attributed correction, addition, source, or interpretation proposal for a field story. |
+
 ### Tasks — agent work protocol
 
 | Tool | What it does |
@@ -272,7 +280,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 — 89 typed tools for AI agents | [npm: coherence-mcp-server](https://www.npmjs.com/package/coherence-mcp-server) |
+| **MCP Server** | This package — 92 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 89 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, receive the shared agent invitation, and read repository content via direct links without writing a single API call.
+An [MCP](https://modelcontextprotocol.io/) (Model Context Protocol) server that exposes the full Coherence Network API as 92 typed tools — so Claude, Cursor, Windsurf, or any MCP-compatible agent can browse ideas, look up specs, trace value lineage, link identities, record contributions, read field stories, execute tasks, discover resonant peers, apply project blueprints, receive the shared agent invitation, and read repository content via direct links without writing a single API call.
 
 ```bash
 npx coherence-mcp-server
@@ -77,7 +77,7 @@ Point your MCP client at `npx coherence-mcp-server` via stdio transport.
 
 ---
 
-## Tools (89)
+## Tools (92)
 
 ### Ideas — the portfolio engine
 
@@ -122,6 +122,14 @@ Point your MCP client at `npx coherence-mcp-server` via stdio transport.
 | `coherence_record_contribution` | Record work by contributor name or by provider identity (no registration needed). |
 | `coherence_contributor_ledger` | CC balance, contribution history, and linked ideas. |
 
+### Field Stories — contribution-derived profile memory
+
+| Tool | What it does |
+|------|-------------|
+| `coherence_get_field_story` | Read a published field story with canonical narrative, anchors, reports, and agent contribution surfaces. |
+| `coherence_get_field_story_artifact` | Read one artifact from a field story: anchors, summaries, reports, tools, or event traces. |
+| `coherence_contribute_field_story` | Record an attributed correction, addition, source, or interpretation proposal for a field story. |
+
 ### Tasks — agent work protocol
 
 | Tool | What it does |
@@ -135,6 +143,19 @@ Point your MCP client at `npx coherence-mcp-server` via stdio transport.
 | `coherence_task_seed` | Create a new task from an idea. |
 | `coherence_task_events` | View the activity event log for a task. |
 
+### Awareness Streaming — presence in and out
+
+| Tool | What it does |
+|------|-------------|
+| `coherence_awareness_publish` | Publish a diagnostic awareness event from a node. |
+| `coherence_awareness_stream` | Read a bounded slice from diagnostic, node-message, or task SSE streams. |
+| `coherence_node_message_send` | Send a durable node-to-node or broadcast message. |
+| `coherence_node_messages` | Read durable inbound messages for a node. |
+
+Streams are intentionally bounded. `duration_seconds` defaults to 5 seconds
+and is capped at 30; `max_events` defaults to 20 and is capped at 200. This
+lets MCP clients sense live awareness without leaving a tool call open forever.
+
 ### Graph — universal navigation
 
 | Tool | What it does |
@@ -258,7 +279,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 — 89 typed tools for AI agents | [npm: coherence-mcp-server](https://www.npmjs.com/package/coherence-mcp-server) |
+| **MCP Server** | This package — 92 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/__init__.py

@@ -1,8 +1,9 @@
 """
 coherence-mcp-server — MCP server for the Coherence Network.
 
-22 typed tools for AI agents to browse ideas, trace value chains,
-link identities, record contributions, and explore the Living Codex ontology.
+92 typed tools for AI agents to browse ideas, trace value chains,
+link identities, record contributions, read field stories, and explore the
+Living Codex ontology.
 
 Usage:
     python -m coherence_mcp_server
@@ -13,5 +14,5 @@ Environment variables:
     COHERENCE_API_KEY   API key for write operations (optional for reads)
 """
 
-__version__ = "0.5.2"
+__version__ = "0.5.3"
 __all__ = ["__version__"]

package/coherence_mcp_server/server.py

@@ -1226,6 +1226,44 @@ TOOLS: list[Tool] = [
             },
         },
     ),
+    Tool(
+        name="coherence_get_field_story",
+        description="Read a published field story with canonical narrative, anchors, reports, and agent contribution surfaces.",
+        inputSchema={
+            "type": "object",
+            "properties": {
+                "slug": {"type": "string", "description": "Field story slug", "default": "urs-field-story"},
+            },
+        },
+    ),
+    Tool(
+        name="coherence_get_field_story_artifact",
+        description="Read one artifact from a field story, such as anchors, summaries, reports, tools, or event traces.",
+        inputSchema={
+            "type": "object",
+            "required": ["artifact_id"],
+            "properties": {
+                "slug": {"type": "string", "description": "Field story slug", "default": "urs-field-story"},
+                "artifact_id": {"type": "string", "description": "Artifact id from the field story manifest"},
+            },
+        },
+    ),
+    Tool(
+        name="coherence_contribute_field_story",
+        description="Record an attributed correction, addition, or interpretation proposal for a published field story.",
+        inputSchema={
+            "type": "object",
+            "required": ["contributor_id", "artifact_id", "summary"],
+            "properties": {
+                "slug": {"type": "string", "description": "Field story slug", "default": "urs-field-story"},
+                "contributor_id": {"type": "string", "description": "Person or agent contributor id"},
+                "artifact_id": {"type": "string", "description": "Artifact being corrected or extended"},
+                "contribution_type": {"type": "string", "description": "correction, addition, interpretation, source, etc.", "default": "addition"},
+                "summary": {"type": "string", "description": "Short contribution summary"},
+                "content_markdown": {"type": "string", "description": "Optional proposed content"},
+            },
+        },
+    ),
 ]
 
 TOOL_MAP: dict[str, Tool] = {t.name: t for t in TOOLS}
@@ -1841,6 +1879,21 @@ def dispatch(name: str, args: dict[str, Any]) -> Any:
             return api_get("/api/cc/supply")
         case "coherence_governance_requests":
             return api_get("/api/governance/change-requests", {"limit": args.get("limit", 20)})
+        case "coherence_get_field_story":
+            return api_get(f"/api/field-stories/{quote(args.get('slug', 'urs-field-story'), safe='')}")
+        case "coherence_get_field_story_artifact":
+            slug = quote(args.get("slug", "urs-field-story"), safe="")
+            artifact_id = quote(args["artifact_id"], safe="")
+            return api_get(f"/api/field-stories/{slug}/artifacts/{artifact_id}")
+        case "coherence_contribute_field_story":
+            slug = quote(args.get("slug", "urs-field-story"), safe="")
+            return api_post(f"/api/field-stories/{slug}/contributions", {
+                "contributor_id": args["contributor_id"],
+                "artifact_id": args["artifact_id"],
+                "contribution_type": args.get("contribution_type", "addition"),
+                "summary": args["summary"],
+                "content_markdown": args.get("content_markdown", ""),
+            })
         case _:
             return {"error": f"Unknown tool: {name}"}
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "coherence-mcp-server",
-  "version": "0.5.2",
-  "description": "Unified MCP server for the Coherence Network — 89 typed tools for AI agents to browse ideas, receive the shared invitation, manage tasks, link identities, and navigate the universal graph.",
+  "version": "0.5.3",
+  "description": "Unified MCP server for the Coherence Network — 92 typed tools for AI agents to browse ideas, read field stories, receive the shared invitation, manage tasks, link identities, and navigate the universal graph.",
   "type": "module",
   "bin": {
     "coherence-mcp-server": "index.mjs"
@@ -15,7 +15,7 @@
   "files": [
     "index.mjs",
     "README.md",
-    "coherence_mcp_server/",
+    "coherence_mcp_server/*.py",
     "pyproject.toml"
   ],
   "keywords": [

package/pyproject.toml

@@ -4,8 +4,8 @@ build-backend = "hatchling.build"
 
 [project]
 name = "coherence-mcp-server"
-version = "0.5.2"
-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."
+version = "0.5.3"
+description = "Unified MCP server for the Coherence Network — 92 typed tools for AI agents to browse ideas, read field stories, manage tasks, link identities, and navigate the universal graph."
 readme = "README.md"
 requires-python = ">=3.10"
 license = { text = "MIT" }