@gera-services/mcp-gera-nexus 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Gera Services Ltd
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,50 @@
+# @gera-services/mcp-gera-nexus
+
+MCP (Model Context Protocol) server for [GeraNexus](https://geranexus.com) — the open Agentic Commerce Protocol by [Gera Services](https://gera.services).
+
+**Status:** Placeholder (v0.1.0). The full transactional protocol — `negotiate`, `book`, `pay`, `cancel`, `refund`, `dispute`, `verify-completion` — is under development and ships with v1.0.0.
+
+## What is GeraNexus?
+
+GeraNexus extends MCP (query-only) into transactional territory. It's the open protocol every AI agent will speak to interact with any Gera vertical — and eventually any real-world service. Think "Stripe for agent commerce." All 22 Gera verticals (GeraClinic, GeraHome, GeraMarket, GeraEats, GeraRide, GeraCash, and more) will be the reference implementation.
+
+Full spec: [`ceo/strategy/research/five-ideas-for-2030.md`](https://github.com/geraservicesuk/globetura/blob/master/ceo/strategy/research/five-ideas-for-2030.md)
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `info` | Returns current status, planned actions, revenue model, and launch estimate for GeraNexus |
+
+Additional transactional tools (`negotiate`, `book`, `pay`, `cancel`, `refund`, `dispute`, `verify_completion`) will land in v1.0.0.
+
+## Installation
+
+```bash
+npx @gera-services/mcp-gera-nexus
+```
+
+## Usage with Claude Desktop
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "gera-nexus": {
+      "command": "npx",
+      "args": ["@gera-services/mcp-gera-nexus"]
+    }
+  }
+}
+```
+
+## Learn more
+
+- Product: https://geranexus.com
+- Parent company: https://gera.services
+- Full spec: https://github.com/geraservicesuk/globetura/blob/master/ceo/strategy/research/five-ideas-for-2030.md
+
+## License
+
+MIT — (c) 2026 Gera Services Ltd

package/bin/cli.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+require('../dist/server.js');

package/dist/index.js

@@ -0,0 +1,28 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var index_exports = {};
+__export(index_exports, {
+  server: () => import_server.server
+});
+module.exports = __toCommonJS(index_exports);
+var import_server = require("./server.js");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  server
+});

package/dist/server.js

@@ -0,0 +1,74 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var server_exports = {};
+__export(server_exports, {
+  server: () => server
+});
+module.exports = __toCommonJS(server_exports);
+var import_mcp = require("@modelcontextprotocol/sdk/server/mcp.js");
+var import_stdio = require("@modelcontextprotocol/sdk/server/stdio.js");
+const server = new import_mcp.McpServer({
+  name: "gera-nexus",
+  version: "0.1.0"
+});
+server.tool(
+  "info",
+  "Return product information about GeraNexus \u2014 the open Agentic Commerce Protocol by Gera Services. Use this to learn what GeraNexus is, why it exists, and when the full MCP toolset will ship.",
+  {},
+  async () => {
+    const info = {
+      status: "coming-soon",
+      product: "GeraNexus",
+      tagline: "The Agentic Commerce Protocol",
+      description: 'An open protocol extending MCP into transactional territory so any AI agent can negotiate, book, pay, cancel, refund, dispute, and verify completion across real-world services. Gera exposes all 22 verticals (GeraClinic, GeraHome, GeraMarket, GeraEats, GeraRide, GeraCash, and more) as reference implementations. Goal: become "Stripe for agent commerce."',
+      category: "Infrastructure / Protocol",
+      plannedActions: [
+        "negotiate",
+        "book",
+        "pay",
+        "cancel",
+        "refund",
+        "dispute",
+        "verify-completion"
+      ],
+      revenueModel: [
+        "2% transaction fee on agent-initiated commerce",
+        "Protocol governance fees from third-party marketplaces",
+        "Premium tier: higher volume, priority support, dispute SLA"
+      ],
+      launchEstimate: "Q3-Q4 2026",
+      learnMore: "https://geranexus.com",
+      parentCompany: "Gera Services Ltd (https://gera.services)",
+      fullSpec: "https://github.com/geraservicesuk/globetura/blob/master/ceo/strategy/research/five-ideas-for-2030.md"
+    };
+    return {
+      content: [{ type: "text", text: JSON.stringify(info, null, 2) }]
+    };
+  }
+);
+async function main() {
+  const transport = new import_stdio.StdioServerTransport();
+  await server.connect(transport);
+  console.error("GeraNexus MCP server (placeholder v0.1.0) running on stdio");
+}
+main().catch(console.error);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  server
+});

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@gera-services/mcp-gera-nexus",
+  "version": "0.1.0",
+  "description": "MCP server for GeraNexus — the open Agentic Commerce Protocol by Gera Services. Placeholder; full transactional protocol (negotiate, book, pay, cancel, refund, dispute) launching 2026.",
+  "mcpName": "io.github.geraservicesuk/mcp-gera-nexus",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "mcp-gera-nexus": "bin/cli.js"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "README.md",
+    "LICENSE",
+    "server.json"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "node build.mjs",
+    "type-check": "tsc --noEmit",
+    "dev": "tsc --watch --noCheck",
+    "start": "node dist/server.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "ai",
+    "gera",
+    "gera-nexus",
+    "ai-agent"
+  ],
+  "author": {
+    "name": "Gera Services",
+    "email": "engineering@gera.services",
+    "url": "https://gera.services"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/geraservicesuk/mcp-gera-nexus"
+  },
+  "homepage": "https://geranexus.com",
+  "bugs": {
+    "url": "https://github.com/geraservicesuk/mcp-gera-nexus/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.12.0",
+    "esbuild": "^0.28.0",
+    "typescript": "^5.4.0"
+  }
+}

package/server.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.geraservicesuk/mcp-gera-nexus",
+  "description": "Placeholder MCP server for GeraNexus — the open Agentic Commerce Protocol by Gera Services. Ships a single `info` tool while the full transactional toolset is under development (launching 2026).",
+  "repository": {
+    "url": "https://github.com/geraservicesuk/mcp-gera-nexus",
+    "source": "github"
+  },
+  "version": "0.1.0",
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "@gera-services/mcp-gera-nexus",
+      "version": "0.1.0",
+      "transport": {
+        "type": "stdio"
+      },
+      "environmentVariables": []
+    }
+  ]
+}