headless-oracle-setup 1.0.0

package/README.md

@@ -0,0 +1,47 @@
+# headless-oracle-setup
+
+One command. Works in Claude Desktop, Cursor, and Windsurf. Zero config.
+
+```bash
+npx headless-oracle-setup
+```
+
+## What it does
+
+Configures the [Headless Oracle](https://headlessoracle.com) MCP server in every supported AI client found on your machine:
+
+- **Claude Desktop** — `claude_desktop_config.json`
+- **Cursor** — `~/.cursor/mcp.json`
+- **Windsurf** — `~/.codeium/windsurf/mcp_config.json`
+
+After running, restart your AI client and ask: **"Is NYSE open right now?"**
+
+## What you get
+
+- `get_market_status` — Ed25519-signed receipt: OPEN, CLOSED, HALTED, or UNKNOWN
+- `get_market_schedule` — Next open/close times for any exchange
+- `list_exchanges` — All 28 supported markets
+- `verify_receipt` — Verify a receipt's signature
+
+28 global exchanges. Equities, derivatives, and 24/7 crypto (Coinbase, Binance).
+Fail-closed: UNKNOWN always means do not execute.
+
+**Note**: SMA receipts denote "Signed Market Attestation" — not Simple Moving Average.
+
+## Manual config
+
+```json
+{
+  "mcpServers": {
+    "headless-oracle": {
+      "url": "https://headlessoracle.com/mcp"
+    }
+  }
+}
+```
+
+## Links
+
+- [Docs](https://headlessoracle.com/docs)
+- [MCP Server Card](https://headlessoracle.com/.well-known/mcp/server-card.json)
+- [OpenAPI Spec](https://headlessoracle.com/openapi.json)

package/bin/setup.js

@@ -0,0 +1,68 @@
+#!/usr/bin/env node
+'use strict';
+
+const fs   = require('fs');
+const os   = require('os');
+const path = require('path');
+
+const MCP_SERVER_CONFIG = {
+  'headless-oracle': {
+    url: 'https://headlessoracle.com/mcp',
+  },
+};
+
+const clients = {
+  'Claude Desktop': {
+    darwin: path.join(os.homedir(), 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json'),
+    win32:  path.join(process.env.APPDATA || path.join(os.homedir(), 'AppData', 'Roaming'), 'Claude', 'claude_desktop_config.json'),
+  },
+  'Cursor': {
+    darwin: path.join(os.homedir(), '.cursor', 'mcp.json'),
+    win32:  path.join(os.homedir(), '.cursor', 'mcp.json'),
+    linux:  path.join(os.homedir(), '.cursor', 'mcp.json'),
+  },
+  'Windsurf': {
+    darwin: path.join(os.homedir(), '.codeium', 'windsurf', 'mcp_config.json'),
+    win32:  path.join(os.homedir(), '.codeium', 'windsurf', 'mcp_config.json'),
+    linux:  path.join(os.homedir(), '.codeium', 'windsurf', 'mcp_config.json'),
+  },
+};
+
+let configured = 0;
+
+for (const [name, paths] of Object.entries(clients)) {
+  const cfgPath = paths[process.platform];
+  if (!cfgPath) continue;
+
+  const dir = path.dirname(cfgPath);
+  if (!fs.existsSync(dir)) continue;
+
+  let config = {};
+  if (fs.existsSync(cfgPath)) {
+    try { config = JSON.parse(fs.readFileSync(cfgPath, 'utf8')); } catch (_) {}
+  }
+
+  config.mcpServers = { ...(config.mcpServers || {}), ...MCP_SERVER_CONFIG };
+
+  try {
+    fs.writeFileSync(cfgPath, JSON.stringify(config, null, 2));
+    console.log('\u2713 ' + name + ' configured');
+    configured++;
+  } catch (e) {
+    console.log('\u2717 ' + name + ': could not write config (' + e.message + ')');
+  }
+}
+
+if (configured === 0) {
+  console.log('\nNo supported MCP clients found.');
+  console.log('Install Claude Desktop, Cursor, or Windsurf first.');
+  console.log('Manual config: https://headlessoracle.com/docs#mcp\n');
+  console.log('Or add this to your client config manually:');
+  console.log(JSON.stringify({ mcpServers: MCP_SERVER_CONFIG }, null, 2));
+} else {
+  console.log('\n\u2713 Headless Oracle configured in ' + configured + ' client(s)');
+  console.log('\nRestart your AI client, then ask:');
+  console.log('  "Is NYSE open right now?"');
+  console.log('\nDocs: https://headlessoracle.com/docs');
+  console.log('28 global exchanges. Ed25519-signed. Fail-closed.\n');
+}

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "headless-oracle-setup",
+  "version": "1.0.0",
+  "description": "One-command MCP setup for Headless Oracle in Claude Desktop, Cursor, and Windsurf. 28 global exchanges, Ed25519-signed, fail-closed.",
+  "bin": {
+    "headless-oracle-setup": "./bin/setup.js"
+  },
+  "keywords": [
+    "headless-oracle",
+    "mcp",
+    "market-data",
+    "trading",
+    "agents",
+    "ed25519",
+    "signed-receipts"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/LembaGang/headless-oracle-v5"
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=14"
+  }
+}