god-prompt-mcp 1.0.21 → 1.0.23

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
@@ -40,6 +40,32 @@ The MCP server does not run the benchmark or claim model-level superiority itsel
40
40
 
41
41
  ## Connect
42
42
 
43
+ ### Hosted remote (no Node.js required)
44
+
45
+ Use the public Streamable HTTP endpoint directly in MCP clients that support remote servers:
46
+
47
+ ```text
48
+ https://god-prompt-mcp.tomi-seregi99.workers.dev/mcp
49
+ ```
50
+
51
+ 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.
52
+
53
+ ### Agent Skills over MCP (SEP-2640)
54
+
55
+ On MCP 2026-07-28, both the hosted and stdio servers advertise the Final `io.modelcontextprotocol/skills` extension from SEP-2640. Supporting clients can discover the same relevance-scoped `god-prompt` Agent Skill with `skills/list` / `skills/get`, then fetch `SKILL.md` and its three reference files through `resources/read`. The skill manifest includes SHA-256 digests and exact byte sizes so clients can verify what they import. Clients that do not implement this extension continue to use the seven existing GodPrompt tools normally.
56
+
57
+ This transports GodPrompt's existing skill package; it does not force the skill into every request or change the host's own approval, verification, or activation policy. See the [MCP Skills extension specification](https://modelcontextprotocol.io/extensions/skills/overview).
58
+
59
+ ### ChatGPT (hosted remote)
60
+
61
+ On ChatGPT web, supported Business and Enterprise/Edu workspaces can connect the hosted endpoint as a custom MCP app in Developer Mode:
62
+
63
+ 1. Enable Developer Mode, then open **Settings > Apps > Create** (workspace controls may require an admin or authorized developer).
64
+ 2. Use `https://god-prompt-mcp.tomi-seregi99.workers.dev/mcp` as the MCP endpoint and select no authentication.
65
+ 3. Choose **Scan Tools**, confirm the seven read-only GodPrompt tools, then create and enable the app for the intended workspace users.
66
+
67
+ 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.
68
+
43
69
  ### npm / npx (recommended)
44
70
 
45
71
  ```bash
@@ -180,7 +206,7 @@ npx -y skills@latest add AKzar1el/god-prompt-mcp --skill god-prompt --agent droi
180
206
  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:
181
207
 
182
208
  ```bash
183
- droid mcp add god-prompt "npx -y god-prompt-mcp@1.0.21"
209
+ droid mcp add god-prompt "npx -y god-prompt-mcp@1.0.23"
184
210
  ```
185
211
 
186
212
  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.
@@ -206,7 +232,7 @@ npx -y skills@latest add AKzar1el/god-prompt-mcp --skill god-prompt --agent goos
206
232
  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:
207
233
 
208
234
  ```bash
209
- goose session --with-extension "npx -y god-prompt-mcp@1.0.21"
235
+ goose session --with-extension "npx -y god-prompt-mcp@1.0.23"
210
236
  ```
211
237
 
212
238
  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.
@@ -264,7 +290,7 @@ The Trae target installs the skill under `.trae/skills/god-prompt/`, where TraeC
264
290
  "mcpServers": {
265
291
  "god-prompt": {
266
292
  "command": "npx",
267
- "args": ["-y", "god-prompt-mcp@1.0.21"]
293
+ "args": ["-y", "god-prompt-mcp@1.0.23"]
268
294
  }
269
295
  }
270
296
  }
@@ -283,7 +309,7 @@ npx -y skills@latest add AKzar1el/god-prompt-mcp --skill god-prompt --agent open
283
309
  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:
284
310
 
285
311
  ```bash
286
- openclaw mcp add god-prompt --command npx --arg -y --arg god-prompt-mcp@1.0.21
312
+ openclaw mcp add god-prompt --command npx --arg -y --arg god-prompt-mcp@1.0.23
287
313
  openclaw mcp probe god-prompt
288
314
  ```
289
315
 
@@ -304,7 +330,7 @@ The Qoder target installs the skill under `.qoder/skills/god-prompt/`, where Qod
304
330
  "mcpServers": {
305
331
  "god-prompt": {
306
332
  "command": "npx",
307
- "args": ["-y", "god-prompt-mcp@1.0.21"]
333
+ "args": ["-y", "god-prompt-mcp@1.0.23"]
308
334
  }
309
335
  }
310
336
  }
@@ -344,7 +370,7 @@ Kimi Code CLI can install GodPrompt as one native custom plugin containing the e
344
370
  /reload
345
371
  ```
346
372
 
347
- 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.21` 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.
373
+ 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.23` 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.
348
374
 
349
375
  ### JetBrains AI Assistant
350
376
 
@@ -461,11 +487,11 @@ Example client configuration:
461
487
 
462
488
  ## Privacy Policy
463
489
 
464
- GodPrompt MCP is a local stdio server. Its content tools return static GodPrompt material bundled with the installed extension, and `classify_task` evaluates the supplied task description in the local Node.js process.
490
+ GodPrompt MCP can run either as a local stdio server or through the public Streamable HTTP Worker. Its content tools return static GodPrompt material bundled with the server, and `classify_task` is deterministic; neither mode calls a model or third-party content API.
465
491
 
466
- - **Data collection and use:** the server has no telemetry or analytics and does not collect account data. Tool input is used only to produce the requested local response.
467
- - **Storage and retention:** the server has no server-side persistence and does not retain tool inputs after a request completes.
468
- - **Third-party sharing:** the server does not transmit tool inputs or bundled GodPrompt content to an external API or third party. The MCP host or AI client may process conversation and tool data under its own policies independently of this server.
492
+ - **Data collection and use:** GodPrompt application code has no telemetry or analytics and does not request account data. Local stdio tool input stays in the local Node.js process. Hosted remote tool input is sent over HTTPS to the Cloudflare-hosted Worker so it can produce the MCP response.
493
+ - **Storage and retention:** the MCP request handlers are stateless and have no application database or request-retention path; they do not intentionally persist tool inputs after a request completes. Hosting/provider infrastructure may process connection or request metadata under its own policies.
494
+ - **Third-party sharing:** local stdio does not transmit tool inputs or bundled GodPrompt content to an external API. The hosted remote necessarily passes the request through Cloudflare infrastructure, but GodPrompt application code does not forward tool inputs to another API or service. The MCP host or AI client may process conversation and tool data under its own policies independently of this server.
469
495
  - **Contact and policy:** see [tomiseregi.si/privacy](https://tomiseregi.si/privacy) for the current privacy policy and contact information. For support or bug reports, use [GitHub Issues](https://github.com/AKzar1el/god-prompt-mcp/issues).
470
496
 
471
497
  ## Development
package/dist/server.js CHANGED
@@ -1,16 +1,11 @@
1
1
  import * as z from "zod/v4";
2
2
  import { CONTENT, VERSION } from "./content.js";
3
+ import { CORE_SKILL } from "./skill-content.js";
3
4
  export const SERVER_INFO = {
4
5
  name: "god-prompt-mcp",
5
- version: "1.0.21",
6
+ version: "1.0.23",
6
7
  };
7
- // Version 1.0.0 was generated before the source layout moved from core/* to
8
- // SKILL.md + references/*. Normalize only those legacy links at the serving
9
- // boundary; regenerated content from the repaired generator makes this a no-op.
10
- const CORE_SKILL = CONTENT.CORE_SKILL
11
- .replaceAll("core/01-PROTOCOLS.md", "references/01-PROTOCOLS.md")
12
- .replaceAll("core/02-GATES.md", "references/02-GATES.md")
13
- .replaceAll("core/03-ANTI-PATTERNS.md", "references/03-ANTI-PATTERNS.md");
8
+ export const SERVER_INSTRUCTIONS = "Start with get_core_skill for the lean GodPrompt protocol. Use classify_task to route a concrete task, then load get_protocols, get_gates, or get_anti_patterns only when that focused reference is needed. Use get_god_prompt only when the full single-file payload is preferable. All GodPrompt tools are read-only.";
14
9
  const READ_ONLY_ANNOTATIONS = {
15
10
  readOnlyHint: true,
16
11
  destructiveHint: false,
@@ -0,0 +1,8 @@
1
+ import { CONTENT } from "./content.js";
2
+ // Version 1.0.0 was generated before the source layout moved from core/* to
3
+ // SKILL.md + references/*. Normalize only those legacy links at the serving
4
+ // boundary; regenerated content from the repaired generator makes this a no-op.
5
+ export const CORE_SKILL = CONTENT.CORE_SKILL
6
+ .replaceAll("core/01-PROTOCOLS.md", "references/01-PROTOCOLS.md")
7
+ .replaceAll("core/02-GATES.md", "references/02-GATES.md")
8
+ .replaceAll("core/03-ANTI-PATTERNS.md", "references/03-ANTI-PATTERNS.md");
package/dist/skills.js ADDED
@@ -0,0 +1,125 @@
1
+ import * as z from "zod/v4";
2
+ import { CONTENT } from "./content.js";
3
+ import { CORE_SKILL } from "./skill-content.js";
4
+ const EXTENSION_ID = "io.modelcontextprotocol/skills";
5
+ const SKILL_URI = "skill://god-prompt/SKILL.md";
6
+ const CACHE_TTL_MS = 300_000;
7
+ const SKILL_FILES = [
8
+ { uri: SKILL_URI, text: CORE_SKILL },
9
+ {
10
+ uri: "skill://god-prompt/references/01-PROTOCOLS.md",
11
+ text: CONTENT.PROTOCOLS,
12
+ },
13
+ {
14
+ uri: "skill://god-prompt/references/02-GATES.md",
15
+ text: CONTENT.GATES,
16
+ },
17
+ {
18
+ uri: "skill://god-prompt/references/03-ANTI-PATTERNS.md",
19
+ text: CONTENT.ANTI_PATTERNS,
20
+ },
21
+ ];
22
+ function parseFrontmatter(skill) {
23
+ const normalized = skill.replaceAll("\r\n", "\n");
24
+ const match = /^---\n([\s\S]*?)\n---(?:\n|$)/.exec(normalized);
25
+ if (!match)
26
+ throw new Error("GodPrompt SKILL.md is missing YAML frontmatter");
27
+ const lines = match[1].split("\n");
28
+ const frontmatter = {};
29
+ for (let index = 0; index < lines.length; index += 1) {
30
+ const line = lines[index];
31
+ if (!line.trim())
32
+ continue;
33
+ const scalar = /^(name|license):\s*(.+)$/.exec(line);
34
+ if (scalar) {
35
+ frontmatter[scalar[1]] = scalar[2].trim();
36
+ continue;
37
+ }
38
+ if (line === "description: |") {
39
+ const description = [];
40
+ while (index + 1 < lines.length && lines[index + 1].startsWith(" ")) {
41
+ index += 1;
42
+ description.push(lines[index].slice(2));
43
+ }
44
+ frontmatter.description = `${description.join("\n")}\n`;
45
+ continue;
46
+ }
47
+ throw new Error(`Unsupported GodPrompt SKILL.md frontmatter line: ${line}`);
48
+ }
49
+ if (!frontmatter.name || !frontmatter.description) {
50
+ throw new Error("GodPrompt SKILL.md frontmatter must include name and description");
51
+ }
52
+ return frontmatter;
53
+ }
54
+ const SKILL_FRONTMATTER = parseFrontmatter(CORE_SKILL);
55
+ async function sha256(text) {
56
+ const bytes = new TextEncoder().encode(text);
57
+ const digest = await crypto.subtle.digest("SHA-256", bytes);
58
+ const hex = Array.from(new Uint8Array(digest), (byte) => byte.toString(16).padStart(2, "0")).join("");
59
+ return `sha256:${hex}`;
60
+ }
61
+ async function buildSkillEntry() {
62
+ return {
63
+ uri: SKILL_URI,
64
+ frontmatter: SKILL_FRONTMATTER,
65
+ resources: await Promise.all(SKILL_FILES.map(async ({ uri, text }) => ({
66
+ uri,
67
+ digest: await sha256(text),
68
+ size: new TextEncoder().encode(text).byteLength,
69
+ }))),
70
+ };
71
+ }
72
+ const listSkillsParams = z.object({
73
+ cursor: z.string().optional(),
74
+ });
75
+ const getSkillParams = z.object({
76
+ uri: z.string(),
77
+ });
78
+ export function registerGodPromptSkillExtension(server) {
79
+ for (const { uri, text } of SKILL_FILES) {
80
+ const isRootSkill = uri === SKILL_URI;
81
+ server.registerResource(isRootSkill ? "god-prompt" : uri.slice("skill://god-prompt/".length), uri, {
82
+ mimeType: "text/markdown",
83
+ ...(isRootSkill
84
+ ? {
85
+ description: SKILL_FRONTMATTER.description.trim(),
86
+ }
87
+ : {}),
88
+ }, async (resourceUri) => ({
89
+ contents: [
90
+ {
91
+ uri: resourceUri.href,
92
+ mimeType: "text/markdown",
93
+ text,
94
+ },
95
+ ],
96
+ }));
97
+ }
98
+ server.server.registerCapabilities({
99
+ extensions: {
100
+ [EXTENSION_ID]: {},
101
+ },
102
+ });
103
+ server.server.setRequestHandler("skills/list", { params: listSkillsParams }, async ({ cursor }) => {
104
+ if (cursor !== undefined) {
105
+ throw new Error("GodPrompt serves one skills/list page and does not issue cursors");
106
+ }
107
+ return {
108
+ resultType: "complete",
109
+ skills: [await buildSkillEntry()],
110
+ ttlMs: CACHE_TTL_MS,
111
+ cacheScope: "public",
112
+ };
113
+ });
114
+ server.server.setRequestHandler("skills/get", { params: getSkillParams }, async ({ uri }) => {
115
+ if (uri !== SKILL_URI) {
116
+ throw new Error(`Unknown GodPrompt skill URI: ${uri}`);
117
+ }
118
+ return {
119
+ resultType: "complete",
120
+ skill: await buildSkillEntry(),
121
+ ttlMs: CACHE_TTL_MS,
122
+ cacheScope: "public",
123
+ };
124
+ });
125
+ }
package/dist/stdio.js CHANGED
@@ -1,10 +1,12 @@
1
1
  #!/usr/bin/env node
2
2
  import { McpServer } from "@modelcontextprotocol/server";
3
3
  import { serveStdio } from "@modelcontextprotocol/server/stdio";
4
- import { registerGodPromptTools, SERVER_INFO } from "./server.js";
4
+ import { registerGodPromptTools, SERVER_INFO, SERVER_INSTRUCTIONS, } from "./server.js";
5
+ import { registerGodPromptSkillExtension } from "./skills.js";
5
6
  function createServer() {
6
- const server = new McpServer(SERVER_INFO);
7
+ const server = new McpServer(SERVER_INFO, { instructions: SERVER_INSTRUCTIONS });
7
8
  registerGodPromptTools(server);
9
+ registerGodPromptSkillExtension(server);
8
10
  return server;
9
11
  }
10
12
  await serveStdio(createServer);
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "god-prompt-mcp",
3
- "version": "1.0.21",
3
+ "version": "1.0.23",
4
4
  "mcpName": "io.github.AKzar1el/god-prompt-mcp",
5
5
  "description": "MCP server for GodPrompt — the universal AI software development system prompt",
6
6
  "private": false,
@@ -9,6 +9,8 @@
9
9
  "files": [
10
10
  "dist/stdio.js",
11
11
  "dist/server.js",
12
+ "dist/skill-content.js",
13
+ "dist/skills.js",
12
14
  "dist/content.js",
13
15
  "README.md",
14
16
  "LICENSE"