god-prompt-mcp 1.0.44 → 1.1.0

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.
package/README.md CHANGED
@@ -12,6 +12,8 @@ GodPrompt offers a bounded Agent Harness Review for developers and small teams w
12
12
 
13
13
  To buy the review, use the [US$49 one-time GitHub Sponsors tier](https://github.com/sponsors/AKzar1el/sponsorships?tier_id=657478&metadata_campaign=godprompt_rs1&metadata_offer=agent_harness_review&metadata_source=mcp). GitHub sign-in is required. After sponsoring, email `info@tomiseregi.si` with subject `[GP-RS1] Agent Harness Review` and include the GitHub username used for the sponsorship plus the review inputs. Delivery begins after the US$49 sponsorship is independently verified for this review. The free MIT GodPrompt MCP remains unchanged and free. [See a transparent sample deliverable](https://github.com/AKzar1el/god-prompt/blob/main/AGENT_HARNESS_REVIEW_SAMPLE.md) before deciding; it is illustrative, not a client result or benchmark. [Full frozen experiment terms](https://github.com/AKzar1el/god-prompt/blob/main/MONETIZATION_EXPERIMENT.md).
14
14
 
15
+ **Before emailing, sanitize your review inputs:** remove passwords, API keys, access tokens, recovery codes, regulated or unrelated personal data, and unrelated private repository content. Do not send `.env` files, full private repositories, or unredacted logs that might expose credentials. Share only the minimum sanitized instruction excerpts and failure example needed for the review; if those are insufficient, the scope may need to be narrowed or the review declined under the linked terms.
16
+
15
17
  ## Tools
16
18
 
17
19
  | Tool | Description |
@@ -23,6 +25,20 @@ To buy the review, use the [US$49 one-time GitHub Sponsors tier](https://github.
23
25
  | `get_anti_patterns` | `references/03-ANTI-PATTERNS.md` — red flags & recovery (~9KB) |
24
26
  | `classify_task` | Deterministically route a task to one of 9 GodPrompt task types, or `UNCLASSIFIED` when no reliable signal exists |
25
27
  | `get_version` | Version info and server metadata |
28
+ | `create_work_contract` | Create a portable, fingerprinted task contract with explicit scope, acceptance criteria and required verification commands |
29
+ | `review_work_evidence` | Fail-closed review of reported changed paths, verification receipts, acceptance results and forbidden actions |
30
+
31
+ > **Version 1.1.0:** `create_work_contract` and `review_work_evidence` expand the seven original MCP tools to nine. Older hosted or version-pinned installations may still expose only the original seven until separately updated. Both tools remain stateless and read-only, and neither independently authenticates caller-supplied evidence. See the [task-contract workflow and security limitations](docs/task-contracts.md).
32
+
33
+ ### Optional local proof bridge (from v1.1.0)
34
+
35
+ The new **godprompt-proof** CLI (Node 22+, **no additional dependencies**) can normalize pinned GitHub CI checks and exported Codexify command receipts into inputs for the existing GodPrompt evidence reviewer. It also supports an optional **single 256 KiB local JSONL feedback file** for project-scoped generic lessons, **on-demand read-only metrics**, and **versioned workflow previews** from that same file (no telemetry or automatic rule changes). No database server, GPU, background worker or global telemetry is involved.
36
+
37
+ GitHub can be read directly or from a **sanitized snapshot produced with an existing GitHub connector**, with no new token required for that offline path. Codexify is **client-orchestrated**: the authorized coding agent produces a receipt export, not a direct remote connection from the public Worker. The hosted MCP has **no access** to any user's local feedback file. No automatic uploads, training or rule promotion occur.
38
+
39
+ **The optional CLI ships with v1.1.0**, but it is not installed or enabled automatically on a user's computer. The hosted MCP cannot read local files. See [local proof bridge setup, limitations, and examples](docs/local-proof-bridge.md). The CLI is optional; the MCP server continues to work without it.
40
+
41
+ **ChatGPT publishing and storage:** The public hosted MCP remains **stateless** and does **not** create personal memory or store a JSONL file for ChatGPT users. Per-project learning is an **explicitly enabled local CLI**, not a hosted MCP feature. See [the hosting, privacy, local installation and release checklist](docs/chatgpt-local-first.md). Cloud sync is **not** included.
26
42
 
27
43
  ## Progressive Disclosure
28
44
 
@@ -50,7 +66,7 @@ Use the public Streamable HTTP endpoint directly in MCP clients that support rem
50
66
  https://god-prompt-mcp.tomi-seregi99.workers.dev/mcp
51
67
  ```
52
68
 
53
- The hosted endpoint exposes the same seven read-only GodPrompt tools as the local server and requires no API key or local Node.js runtime. It accepts both the deployed `initialize` flow and the current MCP 2026-07-28 `server/discover` flow so clients can connect while the ecosystem transitions between protocol eras. It is also published as a remote option in the Official MCP Registry alongside the installable stdio packages.
69
+ The hosted endpoint exposes the read-only GodPrompt tools included in its **currently deployed release** and requires no API key or local Node.js runtime. An unreleased source branch can have a different tool list; always inspect the live tool catalog after deployment. It accepts both the deployed `initialize` flow and the current MCP 2026-07-28 `server/discover` flow so clients can connect while the ecosystem transitions between protocol eras. It is also published as a remote option in the Official MCP Registry alongside the installable stdio packages.
54
70
 
55
71
  ### Agent Skills over MCP (SEP-2640)
56
72
 
@@ -64,13 +80,17 @@ For the lowest-friction ChatGPT path, install [GodPrompt from the first-party Pl
64
80
 
65
81
  ### ChatGPT (hosted remote MCP)
66
82
 
67
- On ChatGPT web, supported Business and Enterprise/Edu workspaces can connect the hosted endpoint as a custom MCP app in Developer Mode:
83
+ On ChatGPT web, supported Business and Enterprise/Edu workspaces can connect GodPrompt's hosted endpoint as a custom MCP plugin. Workspace permissions apply: Business admins/owners can create connections; Enterprise/Edu admins/owners and specifically authorized developers can create connections, while only admins/owners publish them for a workspace.
84
+
85
+ 1. Open **Plugins**, select **+**, then **Add custom MCP server**. The current Plugins flow does **not** require Developer Mode.
86
+ 2. Enter a name and `https://god-prompt-mcp.tomi-seregi99.workers.dev/mcp` as the public HTTPS MCP endpoint. Choose **no authentication**; GodPrompt requires no API key.
87
+ 3. Review the risk warning and select **I understand and want to continue**, then **Create as a plugin**.
88
+ 4. Review the discovered read-only GodPrompt tools and metadata (the count depends on the deployed release), then install the plugin if your workspace permits it. Approved ChatGPT tool snapshots may require an admin refresh after a release.
89
+ 5. Start a new ChatGPT chat, type `@`, select the installed GodPrompt plugin, and try a read-only tool. Workspace approval may be required.
68
90
 
69
- 1. Enable Developer Mode, then open **Settings > Apps > Create** (workspace controls may require an admin or authorized developer).
70
- 2. Use `https://god-prompt-mcp.tomi-seregi99.workers.dev/mcp` as the MCP endpoint and select no authentication.
71
- 3. Choose **Scan Tools**, confirm the seven read-only GodPrompt tools, then create and enable the app for the intended workspace users.
91
+ **Legacy custom-app setup:** If your workspace still uses the older interface, open **Settings > Apps > Create** (or the workspace's app settings, if you are an admin/owner), use the same endpoint with no authentication, choose **Scan Tools**, then **Create**. This remains an alternative, not a prerequisite for the current Plugins flow.
72
92
 
73
- ChatGPT connects to remote MCP servers rather than local stdio servers. See OpenAI's [Developer mode and MCP apps in ChatGPT](https://help.openai.com/en/articles/12584461-developer-mode-and-mcp-apps-in-chatgpt) documentation for current availability and workspace controls.
93
+ ChatGPT connects to remote MCP servers rather than directly to local stdio servers. See OpenAI's [Connecting custom MCP servers in ChatGPT](https://help.openai.com/en/articles/12584461-connecting-custom-mcp-servers-in-chatgpt) for current permissions and setup steps.
74
94
 
75
95
  ### npm / npx (recommended)
76
96
 
@@ -91,6 +111,19 @@ The public npm package runs the local stdio server directly. It requires Node.js
91
111
 
92
112
  This is a client-launcher workaround, not a GodPrompt MCP server change. Keep existing working cross-platform `npx` configurations unchanged.
93
113
 
114
+ ### Docker / GHCR (local stdio; no host Node.js)
115
+
116
+ For MCP clients that can launch a local process, the [public GHCR image](https://github.com/AKzar1el/god-prompt-mcp/pkgs/container/god-prompt-mcp) runs the read-only tools of its pinned published version without requiring Node.js on the host. Docker with Linux-container support is required; no API key is needed.
117
+
118
+ ```json
119
+ {
120
+ "command": "docker",
121
+ "args": ["run", "--rm", "-i", "ghcr.io/akzar1el/god-prompt-mcp:1.1.0"]
122
+ }
123
+ ```
124
+
125
+ Keep `-i` so the MCP client can exchange JSON-RPC over standard input/output; do not add `-t` (a TTY changes the stdio stream). The version tag selects the verified v1.1.0 image; update it deliberately for future releases rather than silently following the moving `latest` tag. The image is Linux/amd64 and runs as non-root user `10001:10001`. If Docker is unavailable, use the [hosted remote endpoint](#hosted-remote-no-nodejs-required) instead.
126
+
94
127
  ### Glama
95
128
 
96
129
  GodPrompt MCP is published on [Glama](https://glama.ai/mcp/servers/AKzar1el/god-prompt-mcp). Use the server page to inspect the tools and connect it to a supported MCP client.
@@ -125,7 +158,7 @@ If you only want the Agent Skill, install it at user scope so VS Code discovers
125
158
  gh skill install AKzar1el/god-prompt-mcp skills/god-prompt --agent github-copilot --scope user
126
159
  ```
127
160
 
128
- If you only want the seven callable MCP tools, use the native MCP install button:
161
+ If you only want the callable MCP tools, use the native MCP install button:
129
162
 
130
163
  [![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_GodPrompt_MCP-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect?url=vscode:mcp/install?%7B%22name%22%3A%22god-prompt-mcp%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22god-prompt-mcp%22%5D%7D)
131
164
 
@@ -243,7 +276,7 @@ Amp can load GodPrompt as an Agent Skill and expose the MCP tools only when that
243
276
  npx -y skills@latest add AKzar1el/god-prompt-mcp --skill god-prompt --agent amp --copy -y
244
277
  ```
245
278
 
246
- The skill includes Amp's sibling `mcp.json` configuration, pinned to the current GodPrompt MCP package. Amp keeps those seven MCP tool definitions hidden until the skill loads, avoiding a permanently expanded tool context while preserving the full progressive-disclosure surface. Node.js 22+ is required for the MCP server.
279
+ The skill includes Amp's sibling `mcp.json` configuration, pinned to the current GodPrompt MCP package. Amp keeps those MCP tool definitions hidden until the skill loads, avoiding a permanently expanded tool context while preserving the full progressive-disclosure surface. Node.js 22+ is required for the MCP server.
247
280
 
248
281
  ### Factory Droid
249
282
 
@@ -256,10 +289,10 @@ npx -y skills@latest add AKzar1el/god-prompt-mcp --skill god-prompt --agent droi
256
289
  Droid discovers compatible project skills under `.agents/skills/`. To add the callable GodPrompt tools as a local stdio MCP server, use Droid's native MCP command with the published version pinned:
257
290
 
258
291
  ```bash
259
- droid mcp add god-prompt "npx -y god-prompt-mcp@1.0.44"
292
+ droid mcp add god-prompt "npx -y god-prompt-mcp@1.1.0"
260
293
  ```
261
294
 
262
- Open `/mcp` in Droid to verify the server and available tools. The Agent Skill supplies the reusable workflow while MCP exposes GodPrompt's seven progressive-disclosure tools. Node.js 22+ is required for the MCP server.
295
+ Open `/mcp` in Droid to verify the server and available tools. The Agent Skill supplies the reusable workflow while MCP exposes GodPrompt's read-only task and protocol tools. Node.js 22+ is required for the MCP server.
263
296
 
264
297
  ### Warp
265
298
 
@@ -282,7 +315,7 @@ npx -y skills@latest add AKzar1el/god-prompt-mcp --skill god-prompt --agent goos
282
315
  Goose discovers the copied skill under `.goose/skills/god-prompt/`. To expose GodPrompt's callable tools for a session, start Goose with the published MCP package as an external stdio extension:
283
316
 
284
317
  ```bash
285
- goose session --with-extension "npx -y god-prompt-mcp@1.0.44"
318
+ goose session --with-extension "npx -y god-prompt-mcp@1.1.0"
286
319
  ```
287
320
 
288
321
  Goose currently treats Agent Skills and MCP extensions as separate native surfaces, so this path does not depend on Agent Plugins support. The skill supplies the reusable workflow while MCP exposes GodPrompt's seven progressive-disclosure tools. Node.js 22+ is required for the MCP server.
@@ -347,7 +380,7 @@ The Trae target installs the skill under `.trae/skills/god-prompt/`, where TraeC
347
380
  "mcpServers": {
348
381
  "god-prompt": {
349
382
  "command": "npx",
350
- "args": ["-y", "god-prompt-mcp@1.0.44"]
383
+ "args": ["-y", "god-prompt-mcp@1.1.0"]
351
384
  }
352
385
  }
353
386
  }
@@ -366,7 +399,7 @@ npx -y skills@latest add AKzar1el/god-prompt-mcp --skill god-prompt --agent open
366
399
  The copied skill lands under `.agents/skills/god-prompt/`, one of OpenClaw's documented project skill roots. To expose GodPrompt's callable tools to OpenClaw-managed agent runtimes as well, register the published stdio server:
367
400
 
368
401
  ```bash
369
- openclaw mcp add god-prompt --command npx --arg -y --arg god-prompt-mcp@1.0.44
402
+ openclaw mcp add god-prompt --command npx --arg -y --arg god-prompt-mcp@1.1.0
370
403
  openclaw mcp probe god-prompt
371
404
  ```
372
405
 
@@ -387,7 +420,7 @@ The Qoder target installs the skill under `.qoder/skills/god-prompt/`, where Qod
387
420
  "mcpServers": {
388
421
  "god-prompt": {
389
422
  "command": "npx",
390
- "args": ["-y", "god-prompt-mcp@1.0.44"]
423
+ "args": ["-y", "god-prompt-mcp@1.1.0"]
391
424
  }
392
425
  }
393
426
  }
@@ -427,7 +460,7 @@ Kimi Code CLI can install GodPrompt as one native custom plugin containing the e
427
460
  /reload
428
461
  ```
429
462
 
430
- The Kimi manifest points at `skills/`, so the `god-prompt` skill remains available through Kimi's normal relevance-based skill loading instead of being forced into every session. The same manifest exposes `god-prompt-mcp@1.0.44` as a local stdio MCP server, preserving the seven progressive-disclosure tools. The explicit `tree/main` URL matters because Kimi's bare GitHub-repository install form prefers the latest GitHub release; using `main` makes the current plugin manifest available without forcing a documentation-only npm/MCP Registry release. Node.js 22+ is required for the MCP server.
463
+ The Kimi manifest points at `skills/`, so the `god-prompt` skill remains available through Kimi's normal relevance-based skill loading instead of being forced into every session. The same manifest exposes `god-prompt-mcp@1.1.0` as a local stdio MCP server, including the nine tools available in v1.1.0. The explicit `tree/main` URL matters because Kimi's bare GitHub-repository install form prefers the latest GitHub release; using `main` makes the current plugin manifest available without forcing a documentation-only npm/MCP Registry release. Node.js 22+ is required for the MCP server.
431
464
 
432
465
  ### JetBrains AI Assistant
433
466