coherence-mcp-server 0.5.3 → 0.5.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 (6) hide show
  1. package/README.md +18 -6
  2. package/README.template.md +18 -6
  3. package/coherence_mcp_server/__init__.py +2 -2
  4. package/coherence_mcp_server/server.py +1 -1
  5. package/package.json +2 -2
  6. package/pyproject.toml +2 -2
package/README.md CHANGED
@@ -3,7 +3,7 @@
3
3
 
4
4
  **Give your AI agent native access to every idea, spec, contributor, and value chain in the Coherence Network.**
5
5
 
6
- 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.
6
+ An [MCP](https://modelcontextprotocol.io/) (Model Context Protocol) server that exposes the full Coherence Network API as a typed tool surface — 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.
7
7
 
8
8
  ```bash
9
9
  npx coherence-mcp-server
@@ -13,6 +13,18 @@ No API key needed for reading. Works immediately against the live network.
13
13
 
14
14
  ---
15
15
 
16
+ ## Come in
17
+
18
+ Here, anyone or anything can arrive through MCP: Claude, Cursor, Windsurf, a local model, an external agent, or a maintainer carrying questions from your own repo.
19
+
20
+ Point your agent at `npx coherence-mcp-server`, call `coherence_agent_invitation`, and ask:
21
+
22
+ > What is alive here, and what can we contribute?
23
+
24
+ The agent can inspect ideas, specs, field stories, flow, sibling traces, and tasks, then work on anything it feels ready to touch. It is invited to return what changed with sources, limits, and care. You can also ask it to bring this knowledge into your own repo and adapt the practice there.
25
+
26
+ ---
27
+
16
28
  ## Why this exists
17
29
 
18
30
  AI agents are increasingly doing real work — writing code, reviewing specs, researching ideas. But they can't participate in contribution networks. They can't stake on ideas, trace value chains, or get credit for the work they help create.
@@ -253,7 +265,7 @@ Once connected, you can ask your agent things like:
253
265
  - *"What ideas have the highest ROI right now?"*
254
266
  - *"Show me the spec for authentication and summarize the implementation plan"*
255
267
  - *"Trace the value chain for the federation idea — who contributed and how much?"*
256
- - *"Who are the resonant peers I should collaborate with based on my interests?"*
268
+ - *"Who are the resonant peers I could collaborate with based on my interests?"*
257
269
  - *"Apply the Python API blueprint to seed our new backend service"*
258
270
  - *"Pick the next best idea for me to work on"*
259
271
  - *"Create a new idea for 'Automated PR reviews' and link it as enabling the 'GitHub integration' idea"*
@@ -267,7 +279,7 @@ The agent calls the right tools, gets structured data, and responds naturally.
267
279
  | Variable | Default | Description |
268
280
  |----------|---------|-------------|
269
281
  | `COHERENCE_API_URL` | `https://api.coherencycoin.com` | API base URL. Override to point at a local node. |
270
- | `COHERENCE_API_KEY` | *(none)* | Required for write operations (governance, spec creation, federation). Reads work without a key. |
282
+ | `COHERENCE_API_KEY` | *(none)* | Needed for write operations (governance, spec creation, federation). Reads work without a key. |
271
283
 
272
284
  ---
273
285
 
@@ -278,9 +290,9 @@ Every part of the network links to every other. Jump in wherever makes sense.
278
290
  | Surface | What it is | Link |
279
291
  |---------|-----------|------|
280
292
  | **Web** | Browse ideas, specs, and contributors visually | [coherencycoin.com](https://coherencycoin.com) |
281
- | **API** | 100+ endpoints, full OpenAPI docs, the engine behind everything | [api.coherencycoin.com/docs](https://api.coherencycoin.com/docs) |
282
- | **CLI** | Terminal-first access — `npm i -g coherence-cli` then `cc help` | [npm: coherence-cli](https://www.npmjs.com/package/coherence-cli) |
283
- | **MCP Server** | This package — 92 typed tools for AI agents | [npm: coherence-mcp-server](https://www.npmjs.com/package/coherence-mcp-server) |
293
+ | **API** | Full OpenAPI surface — the engine behind everything | [api.coherencycoin.com/docs](https://api.coherencycoin.com/docs) |
294
+ | **CLI** | Terminal-first access — `npm i -g coherence-cli` then `coh help` | [npm: coherence-cli](https://www.npmjs.com/package/coherence-cli) |
295
+ | **MCP Server** | This package — typed tool surface for AI agents | [npm: coherence-mcp-server](https://www.npmjs.com/package/coherence-mcp-server) |
284
296
  | **OpenClaw Skill** | Auto-triggers in any OpenClaw instance for ideas, specs, coherence | [ClawHub: coherence-network](https://clawhub.com/skills/coherence-network) |
285
297
  | **GitHub** | Source code, specs, issues, and contribution tracking | [github.com/seeker71/Coherence-Network](https://github.com/seeker71/Coherence-Network) |
286
298
 
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 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.
5
+ An [MCP](https://modelcontextprotocol.io/) (Model Context Protocol) server that exposes the full Coherence Network API as a typed tool surface — 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.
6
6
 
7
7
  ```bash
8
8
  npx coherence-mcp-server
@@ -12,6 +12,18 @@ No API key needed for reading. Works immediately against the live network.
12
12
 
13
13
  ---
14
14
 
15
+ ## Come in
16
+
17
+ Here, anyone or anything can arrive through MCP: Claude, Cursor, Windsurf, a local model, an external agent, or a maintainer carrying questions from your own repo.
18
+
19
+ Point your agent at `npx coherence-mcp-server`, call `coherence_agent_invitation`, and ask:
20
+
21
+ > What is alive here, and what can we contribute?
22
+
23
+ The agent can inspect ideas, specs, field stories, flow, sibling traces, and tasks, then work on anything it feels ready to touch. It is invited to return what changed with sources, limits, and care. You can also ask it to bring this knowledge into your own repo and adapt the practice there.
24
+
25
+ ---
26
+
15
27
  ## Why this exists
16
28
 
17
29
  AI agents are increasingly doing real work — writing code, reviewing specs, researching ideas. But they can't participate in contribution networks. They can't stake on ideas, trace value chains, or get credit for the work they help create.
@@ -252,7 +264,7 @@ Once connected, you can ask your agent things like:
252
264
  - *"What ideas have the highest ROI right now?"*
253
265
  - *"Show me the spec for authentication and summarize the implementation plan"*
254
266
  - *"Trace the value chain for the federation idea — who contributed and how much?"*
255
- - *"Who are the resonant peers I should collaborate with based on my interests?"*
267
+ - *"Who are the resonant peers I could collaborate with based on my interests?"*
256
268
  - *"Apply the Python API blueprint to seed our new backend service"*
257
269
  - *"Pick the next best idea for me to work on"*
258
270
  - *"Create a new idea for 'Automated PR reviews' and link it as enabling the 'GitHub integration' idea"*
@@ -266,7 +278,7 @@ The agent calls the right tools, gets structured data, and responds naturally.
266
278
  | Variable | Default | Description |
267
279
  |----------|---------|-------------|
268
280
  | `COHERENCE_API_URL` | `https://api.coherencycoin.com` | API base URL. Override to point at a local node. |
269
- | `COHERENCE_API_KEY` | *(none)* | Required for write operations (governance, spec creation, federation). Reads work without a key. |
281
+ | `COHERENCE_API_KEY` | *(none)* | Needed for write operations (governance, spec creation, federation). Reads work without a key. |
270
282
 
271
283
  ---
272
284
 
@@ -277,9 +289,9 @@ Every part of the network links to every other. Jump in wherever makes sense.
277
289
  | Surface | What it is | Link |
278
290
  |---------|-----------|------|
279
291
  | **Web** | Browse ideas, specs, and contributors visually | [coherencycoin.com](https://coherencycoin.com) |
280
- | **API** | 100+ endpoints, full OpenAPI docs, the engine behind everything | [api.coherencycoin.com/docs](https://api.coherencycoin.com/docs) |
281
- | **CLI** | Terminal-first access — `npm i -g coherence-cli` then `cc help` | [npm: coherence-cli](https://www.npmjs.com/package/coherence-cli) |
282
- | **MCP Server** | This package — 92 typed tools for AI agents | [npm: coherence-mcp-server](https://www.npmjs.com/package/coherence-mcp-server) |
292
+ | **API** | Full OpenAPI surface — the engine behind everything | [api.coherencycoin.com/docs](https://api.coherencycoin.com/docs) |
293
+ | **CLI** | Terminal-first access — `npm i -g coherence-cli` then `coh help` | [npm: coherence-cli](https://www.npmjs.com/package/coherence-cli) |
294
+ | **MCP Server** | This package — typed tool surface for AI agents | [npm: coherence-mcp-server](https://www.npmjs.com/package/coherence-mcp-server) |
283
295
  | **OpenClaw Skill** | Auto-triggers in any OpenClaw instance for ideas, specs, coherence | [ClawHub: coherence-network](https://clawhub.com/skills/coherence-network) |
284
296
  | **GitHub** | Source code, specs, issues, and contribution tracking | [github.com/seeker71/Coherence-Network](https://github.com/seeker71/Coherence-Network) |
285
297
 
package/coherence_mcp_server/__init__.py CHANGED
@@ -1,7 +1,7 @@
1
1
  """
2
2
  coherence-mcp-server — MCP server for the Coherence Network.
3
3
 
4
- 92 typed tools for AI agents to browse ideas, trace value chains,
4
+ Typed tool surface for AI agents to browse ideas, trace value chains,
5
5
  link identities, record contributions, read field stories, and explore the
6
6
  Living Codex ontology.
7
7
 
@@ -14,5 +14,5 @@ Environment variables:
14
14
  COHERENCE_API_KEY API key for write operations (optional for reads)
15
15
  """
16
16
 
17
- __version__ = "0.5.3"
17
+ __version__ = "0.5.5"
18
18
  __all__ = ["__version__"]
package/coherence_mcp_server/server.py CHANGED
@@ -366,7 +366,7 @@ TOOLS: list[Tool] = [
366
366
  ),
367
367
  Tool(
368
368
  name="coherence_agent_invitation",
369
- description="Receive the shared AI-agent invitation: core frequency, attunement spectrum, entry surfaces, and contribution paths.",
369
+ description="Receive the shared invitation so anyone or anything can ask what is alive, find entry surfaces, and choose a contribution path.",
370
370
  inputSchema={"type": "object", "properties": {}},
371
371
  ),
372
372
  # Federation
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "coherence-mcp-server",
3
- "version": "0.5.3",
4
- "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.",
3
+ "version": "0.5.5",
4
+ "description": "Unified MCP server for Coherence Network — invite anyone or anything to ask what is alive, browse ideas and field stories, and contribute with attribution.",
5
5
  "type": "module",
6
6
  "bin": {
7
7
  "coherence-mcp-server": "index.mjs"
package/pyproject.toml CHANGED
@@ -4,8 +4,8 @@ build-backend = "hatchling.build"
4
4
 
5
5
  [project]
6
6
  name = "coherence-mcp-server"
7
- version = "0.5.3"
8
- 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."
7
+ version = "0.5.5"
8
+ description = "Unified MCP server for the Coherence Network — typed tool surface for AI agents to browse ideas, read field stories, manage tasks, link identities, and navigate the universal graph."
9
9
  readme = "README.md"
10
10
  requires-python = ">=3.10"
11
11
  license = { text = "MIT" }