@prereason/mcp 0.1.0

package/README.md

@@ -0,0 +1,70 @@
+# @prereason/mcp
+
+MCP bridge for [PreReason](https://www.prereason.com) — connects Claude Desktop to PreReason's Bitcoin & macro data API.
+
+PreReason provides pre-computed context templates with market data, macro indicators, trend analysis, and causal reasoning for LLM agents.
+
+## Quick Start
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "prereason": {
+      "command": "npx",
+      "args": [
+        "-y", "@prereason/mcp",
+        "--header", "Authorization:Bearer YOUR_API_KEY"
+      ]
+    }
+  }
+}
+```
+
+Config file location:
+- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
+- **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
+
+Restart Claude Desktop after editing the config.
+
+## Get an API Key
+
+1. Sign up at [prereason.com](https://www.prereason.com)
+2. Go to Dashboard > Settings > API Keys
+3. Copy your key (starts with `pr_live_`)
+
+## What You Get
+
+5 MCP tools:
+
+| Tool | Description | Auth Required |
+|------|-------------|---------------|
+| `list_templates` | List all 17 context templates | No |
+| `list_metrics` | List all 26 available metrics | No |
+| `get_health` | API health check | No |
+| `get_context` | Fetch a context template | Yes |
+| `get_metric` | Fetch a single metric | Yes |
+
+## Example Prompts
+
+Once connected, ask Claude:
+
+- "What's the current BTC regime?"
+- "Show me the macro snapshot"
+- "What does the full context template say about market conditions?"
+- "List available prereason templates"
+
+## Claude Code / Cursor / Windsurf
+
+These clients support remote HTTP MCP servers directly — no bridge needed:
+
+```
+claude mcp add prereason --transport http https://api.prereason.com/api/mcp
+```
+
+## Links
+
+- [Documentation](https://www.prereason.com/docs#mcp)
+- [API Reference](https://api.prereason.com/.well-known/mcp/server.json)
+- [PreReason](https://www.prereason.com)

package/bin/cli.mjs

@@ -0,0 +1,99 @@
+#!/usr/bin/env node
+/**
+ * @prereason/mcp — MCP bridge for Claude Desktop
+ *
+ * Connects Claude Desktop (stdio) to PreReason's Streamable HTTP MCP endpoint.
+ *
+ * Usage:
+ *   npx @prereason/mcp [--header Key:Value]...
+ *   npx @prereason/mcp <URL> [--header Key:Value]...
+ *
+ * Examples:
+ *   npx @prereason/mcp --header "Authorization:Bearer pr_live_..."
+ *   npx @prereason/mcp https://api.prereason.com/api/mcp --header "Authorization:Bearer pr_live_..."
+ */
+
+import { createRequire } from 'node:module';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
+
+const DEFAULT_URL = 'https://api.prereason.com/api/mcp';
+
+// --- Help / Version ---
+if (process.argv.includes('--help') || process.argv.includes('-h')) {
+  const require = createRequire(import.meta.url);
+  const pkg = require('../package.json');
+  process.stderr.write(`${pkg.name} v${pkg.version}\n\n`);
+  process.stderr.write('Usage:\n');
+  process.stderr.write('  npx @prereason/mcp [--header Key:Value]...\n');
+  process.stderr.write('  npx @prereason/mcp <URL> [--header Key:Value]...\n\n');
+  process.stderr.write('Options:\n');
+  process.stderr.write('  --header Key:Value   Add HTTP header (can be repeated)\n');
+  process.stderr.write('  --help, -h           Show this help\n');
+  process.stderr.write('  --version, -v        Show version\n\n');
+  process.stderr.write(`Default URL: ${DEFAULT_URL}\n`);
+  process.exit(0);
+}
+
+if (process.argv.includes('--version') || process.argv.includes('-v')) {
+  const require = createRequire(import.meta.url);
+  const pkg = require('../package.json');
+  process.stderr.write(`${pkg.version}\n`);
+  process.exit(0);
+}
+
+// --- Parse CLI arguments ---
+let urlArg = DEFAULT_URL;
+const headers = {};
+
+for (let i = 2; i < process.argv.length; i++) {
+  if (process.argv[i] === '--header' && process.argv[i + 1]) {
+    const val = process.argv[++i];
+    const colonIdx = val.indexOf(':');
+    if (colonIdx > 0) {
+      headers[val.slice(0, colonIdx).trim()] = val.slice(colonIdx + 1).trim();
+    }
+  } else if (!process.argv[i].startsWith('-')) {
+    urlArg = process.argv[i];
+  }
+}
+
+const url = new URL(urlArg);
+
+// --- Create transports ---
+const stdio = new StdioServerTransport();
+const http = new StreamableHTTPClientTransport(url, {
+  requestInit: Object.keys(headers).length > 0 ? { headers } : undefined,
+});
+
+// --- Wire message routing ---
+stdio.onmessage = (msg) => {
+  http.send(msg).catch((e) => {
+    process.stderr.write(`[prereason:send] ${e.message}\n`);
+  });
+};
+
+http.onmessage = (msg) => {
+  stdio.send(msg).catch((e) => {
+    process.stderr.write(`[prereason:recv] ${e.message}\n`);
+  });
+};
+
+// --- Error handling ---
+stdio.onerror = (e) => process.stderr.write(`[prereason:stdio] ${e.message}\n`);
+http.onerror = (e) => process.stderr.write(`[prereason:http] ${e.message}\n`);
+
+// --- Graceful shutdown ---
+stdio.onclose = () => {
+  http.close();
+  process.exit(0);
+};
+
+http.onclose = () => {
+  stdio.close();
+  process.exit(0);
+};
+
+// --- Start ---
+await http.start();
+await stdio.start();

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@prereason/mcp",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Connect Claude Desktop to PreReason's Bitcoin & macro data API via MCP",
+  "bin": {
+    "prereason-mcp": "./bin/cli.mjs"
+  },
+  "files": [
+    "bin",
+    "README.md"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.26.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "claude",
+    "bitcoin",
+    "macro",
+    "prereason",
+    "ai",
+    "llm"
+  ],
+  "license": "MIT",
+  "homepage": "https://www.prereason.com/docs#mcp",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/prereason/mcp"
+  }
+}