@ticketnation/stellar-mcp 0.1.0

package/README.md

@@ -0,0 +1,67 @@
+# @ticketnation/stellar-mcp
+
+Official stdio bridge for the Ticket Nation **Stellar OS** MCP server. It lets
+stdio-only MCP clients use the hosted Stellar workflow at
+`https://app.stellarseatsticket.com/api/mcp`.
+
+The package contains no Stellar business logic or credentials. Requests,
+tenant authorization, snapshot review, Buy/Spec decisions, audit evidence,
+purchase-order preparation, and guarded TicketVault operations remain on the
+hosted Stellar OS service.
+
+## Requirements
+
+- Node.js 22 or newer
+- A personal Stellar MCP key issued for an active Stellar OS user
+- Tenant permissions appropriate for each requested operation
+
+## Configure an MCP client
+
+Store the personal key in the client's secret environment. Never put it in a
+prompt, repository, browser URL, or shared configuration file.
+
+```json
+{
+  "mcpServers": {
+    "stellar-os": {
+      "command": "npx",
+      "args": ["-y", "@ticketnation/stellar-mcp@latest"],
+      "env": {
+        "STELLAR_MCP_API_KEY": "stl_mcp_..."
+      }
+    }
+  }
+}
+```
+
+Clients that support authenticated remote Streamable HTTP directly do not need
+this package. Connect them to:
+
+```text
+https://app.stellarseatsticket.com/api/mcp
+```
+
+Send the personal key as a bearer authorization value through the client's
+secret configuration.
+
+## Available workflows
+
+- Verify the acting Stellar user and authorized tenants.
+- Search and review tenant-shared saved event availability snapshots.
+- Create a Buy request for standard approval or a policy-released Spec request.
+- Review Spec execution readiness and declare seats as the assigned purchaser.
+- Separately queue an internal speculative PO and dark/unlisted TicketVault
+  inventory when production safety gates permit it.
+- Observe TicketVault Pricer output and separately publish or withdraw approved
+  Spec inventory.
+
+Snapshot evidence is saved observation data, not live availability. Quantities
+and target prices remain explicit operator decisions. TicketVault mutations
+remain protected by server-side assignment, capability, exact-event,
+purpose-scoped connection, idempotency, audit, queue, and feature-flag controls.
+
+## Key lifecycle
+
+Keys are personal and requests are attributed to that existing Stellar user.
+Revoke the key immediately if it is exposed, the user changes duties, or the
+client no longer needs access.

package/bin/stellar-mcp.js

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+
+const STELLAR_MCP_URL = "https://app.stellarseatsticket.com/api/mcp";
+const apiKey = process.env.STELLAR_MCP_API_KEY?.trim();
+
+if (!apiKey) {
+  process.stderr.write(
+    "STELLAR_MCP_API_KEY is required. Create a personal key in Stellar OS and store it only in your MCP client's secret environment.\n",
+  );
+  process.exit(1);
+}
+
+if (!apiKey.startsWith("stl_mcp_")) {
+  process.stderr.write("STELLAR_MCP_API_KEY has an invalid format.\n");
+  process.exit(1);
+}
+
+// mcp-remote expands the environment placeholder itself. The credential never
+// becomes a command-line argument or package file.
+process.env.STELLAR_MCP_AUTH_HEADER = `Bearer ${apiKey}`;
+delete process.env.STELLAR_MCP_API_KEY;
+process.argv = [
+  process.execPath,
+  "stellar-mcp",
+  STELLAR_MCP_URL,
+  "--header",
+  "Authorization:${STELLAR_MCP_AUTH_HEADER}",
+  "--transport",
+  "http-only",
+  "--silent",
+];
+
+await import("mcp-remote/dist/proxy.js");

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@ticketnation/stellar-mcp",
+  "version": "0.1.0",
+  "description": "Official stdio bridge for the Ticket Nation Stellar OS MCP server.",
+  "type": "module",
+  "private": false,
+  "bin": {
+    "stellar-mcp": "./bin/stellar-mcp.js"
+  },
+  "files": [
+    "bin",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "verify": "node --check bin/stellar-mcp.js",
+    "prepublishOnly": "npm run verify"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "ticketnation",
+    "stellar-os",
+    "ticketing"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/oralecarlangelo/stellar-os.git",
+    "directory": "packages/stellar-mcp"
+  },
+  "homepage": "https://app.stellarseatsticket.com",
+  "license": "UNLICENSED",
+  "dependencies": {
+    "mcp-remote": "0.8.1"
+  }
+}