{"_id":"@cloud-atlas-ai/oh-mcp-server","_rev":"7-6f4c07301cae0a64bab14ed4c2e5c24d","name":"@cloud-atlas-ai/oh-mcp-server","dist-tags":{"latest":"0.3.2"},"versions":{"0.1.0":{"name":"@cloud-atlas-ai/oh-mcp-server","version":"0.1.0","_id":"@cloud-atlas-ai/oh-mcp-server@0.1.0","maintainers":[{"name":"muness217","email":"muness@gmail.com"}],"bin":{"oh-mcp":"dist/index.js"},"dist":{"shasum":"f76713f1405139f6a063b92fc04cc6bc8385d9ce","tarball":"https://registry.npmjs.org/@cloud-atlas-ai/oh-mcp-server/-/oh-mcp-server-0.1.0.tgz","fileCount":9,"integrity":"sha512-R6n0BOqEgPSblsJFvBmPrW2oiDMjzNP9kuXoCcVp3dRR7FZPVSOwnJr3nqUNTU1mgpqSH5fCQPMrDhUurInLCQ==","signatures":[{"sig":"MEYCIQDxExvVQgyPK9udpjn3YNjUGiao2n9hRiMdOwDEgCl7NAIhAMOMtSoazyATSycIuEaO3oKKobedBBK0KvDNx7y1FTEQ","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":61835},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"4452adc30bc534879f5bf49249eb5a914b9e17f8","scripts":{"dev":"tsx src/index.ts","build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"muness217","email":"muness@gmail.com"},"_npmVersion":"11.3.0","description":"MCP server for Open Horizons - enables AI agents to read/write alignment context","directories":{},"_nodeVersion":"24.2.0","dependencies":{"zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.0.0","typescript":"^5.0.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/oh-mcp-server_0.1.0_1766786966601_0.6146677687333679","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@cloud-atlas-ai/oh-mcp-server","version":"0.2.1","_id":"@cloud-atlas-ai/oh-mcp-server@0.2.1","maintainers":[{"name":"muness217","email":"muness@gmail.com"}],"bin":{"oh-mcp":"dist/index.js"},"dist":{"shasum":"e4f1874a9897c1b7157dca80cd938b5ff0f72682","tarball":"https://registry.npmjs.org/@cloud-atlas-ai/oh-mcp-server/-/oh-mcp-server-0.2.1.tgz","fileCount":10,"integrity":"sha512-y8a039EwigebA+QEP25yd2oW33zHTMuNueOtA7JmcOXmcUyevCoigyZlIGucFBYCIWtbguk5NCXa22hG3EJZVg==","signatures":[{"sig":"MEYCIQDsBviYsyXaLpRNNtjE6i6OlJFd8knxLPYMi+RZFmY3GgIhAK14yGBYpab2HPjrqW1ygRhYD+KtH9R7Uf/EgyMVX+ez","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":62679},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"c177599a4416dec8c721b2aae376efd041e5ed34","scripts":{"dev":"tsx src/index.ts","build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"muness217","email":"muness@gmail.com"},"_npmVersion":"11.3.0","description":"MCP server for Open Horizons - enables AI agents to read/write alignment context","directories":{},"_nodeVersion":"24.2.0","dependencies":{"zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.0.0","typescript":"^5.0.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/oh-mcp-server_0.2.1_1766791361468_0.2620704199748496","host":"s3://npm-registry-packages-npm-production"}},"0.2.2":{"name":"@cloud-atlas-ai/oh-mcp-server","version":"0.2.2","_id":"@cloud-atlas-ai/oh-mcp-server@0.2.2","maintainers":[{"name":"muness217","email":"muness@gmail.com"}],"bin":{"oh-mcp":"dist/index.js"},"dist":{"shasum":"414492820a546a8616e3080a4a063c6365a59ce5","tarball":"https://registry.npmjs.org/@cloud-atlas-ai/oh-mcp-server/-/oh-mcp-server-0.2.2.tgz","fileCount":10,"integrity":"sha512-5VnvUdTiAPc6blCZCOxXHfDDk4Jqj1DDvx5M8vqfblfwMUZqd0P/4gQ9dxJouGofq2DT9Ivbp4Z1ncsnBFjEGA==","signatures":[{"sig":"MEUCIQC1XeYGMLAXqAznr/rabNuZRGwhtL9G6g/9eugpJcNZ7AIgE1PQ1W599ZZUyylUzq60vH9TSs7NoznwnUbYBLEjDlo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":61159},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"fe7a7c6c5491998ca13db513eadf7772d3bee8af","scripts":{"dev":"tsx src/index.ts","build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"muness217","email":"muness@gmail.com"},"_npmVersion":"11.3.0","description":"MCP server for Open Horizons - enables AI agents to read/write alignment context","directories":{},"_nodeVersion":"24.2.0","dependencies":{"zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.0.0","typescript":"^5.0.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/oh-mcp-server_0.2.2_1766793867262_0.34116598296938583","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"@cloud-atlas-ai/oh-mcp-server","version":"0.3.0","_id":"@cloud-atlas-ai/oh-mcp-server@0.3.0","maintainers":[{"name":"muness217","email":"muness@gmail.com"}],"bin":{"oh-mcp":"dist/index.js"},"dist":{"shasum":"f5e8cc8b2097e22188793faad36265c8ee6f9362","tarball":"https://registry.npmjs.org/@cloud-atlas-ai/oh-mcp-server/-/oh-mcp-server-0.3.0.tgz","fileCount":10,"integrity":"sha512-O4DqxMRqw6+8ci9/1iGWN+WsU6sXfaBpq5OlEl3WiehZCqjVjhx6Cw2Fk2H8HVqvXUiZRCIhnoZ62Tg+X6SbCg==","signatures":[{"sig":"MEYCIQDCJb/5ZM1/XBxH1q48+o+jzJJEoeUsFofuNqIkBFmH2QIhAL4jv1m0xV0E8ENIgg+MmHnK22KkwxkR0EAghAu2OMqW","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":69177},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"28087d743f46e9a120ef9d821ccb70736ab513fd","scripts":{"dev":"tsx src/index.ts","build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"muness217","email":"muness@gmail.com"},"_npmVersion":"11.3.0","description":"MCP server for Open Horizons - enables AI agents to read/write alignment context","directories":{},"_nodeVersion":"24.2.0","dependencies":{"zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.0.0","typescript":"^5.0.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/oh-mcp-server_0.3.0_1766799727877_0.8673048708643085","host":"s3://npm-registry-packages-npm-production"}},"0.3.1":{"name":"@cloud-atlas-ai/oh-mcp-server","version":"0.3.1","_id":"@cloud-atlas-ai/oh-mcp-server@0.3.1","maintainers":[{"name":"muness217","email":"muness@gmail.com"},{"name":"mellowninja","email":"drazen@urch.eu"}],"bin":{"oh-mcp":"dist/index.js"},"dist":{"shasum":"77102679e296eb2d72e52f7967e9307eb75d1d89","tarball":"https://registry.npmjs.org/@cloud-atlas-ai/oh-mcp-server/-/oh-mcp-server-0.3.1.tgz","fileCount":15,"integrity":"sha512-7tEYSFBgZjKNFxZJvYTsRj519ezDotrKPnOy8fcsE8m1+kRDqgDxgEeH5JPD4ixtn23kZ4qVaUrn/wGOY22jcA==","signatures":[{"sig":"MEQCIBMoLj09EsxfdE/ONnWeOVYcrye2HN18ydw4xWguHW3fAiAmk5Nl46hMqiBQCokQifuu3NUESJ1UvF1sgY46j1QK5A==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":102482},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"9d3a71d76434c43cb1a09d1835f906c4abf7e991","scripts":{"dev":"tsx src/index.ts","build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"mellowninja","email":"drazen@urch.eu"},"_npmVersion":"8.13.2","description":"MCP server for Open Horizons - enables AI agents to read/write alignment context","directories":{},"_nodeVersion":"25.1.0","dependencies":{"zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.0.0","typescript":"^5.0.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/oh-mcp-server_0.3.1_1766969812396_0.9534405658217415","host":"s3://npm-registry-packages-npm-production"}},"0.3.2":{"name":"@cloud-atlas-ai/oh-mcp-server","version":"0.3.2","description":"MCP server for Open Horizons - enables AI agents to read/write alignment context","type":"module","main":"dist/index.js","bin":{"oh-mcp":"dist/index.js"},"scripts":{"build":"tsc","dev":"tsx src/index.ts","start":"node dist/index.js"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0","zod":"^3.23.8"},"devDependencies":{"@types/node":"^20.0.0","tsx":"^4.0.0","typescript":"^5.0.0"},"types":"./dist/index.d.ts","gitHead":"9d3a71d76434c43cb1a09d1835f906c4abf7e991","_id":"@cloud-atlas-ai/oh-mcp-server@0.3.2","_nodeVersion":"25.1.0","_npmVersion":"8.13.2","dist":{"integrity":"sha512-J/00TG51vb4hwQAE1bBKZnNmh6QiqRlEcMHaXZufL+6rnEeijNgoNq5g1xv/MtgLU9Rxb2Him33u7PslIv75Ig==","shasum":"447666b5103f8b70897b27f744b53f6a7dd07410","tarball":"https://registry.npmjs.org/@cloud-atlas-ai/oh-mcp-server/-/oh-mcp-server-0.3.2.tgz","fileCount":15,"unpackedSize":102609,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCCsQ9iXB9QTzxly4xKaP4qGZ/Us1dAHjVXnG/4+dIcjgIhALzDP3dAMtBOnPn1xHhJviD4U6jVmyZ+TrAtAc6NaTFE"}]},"_npmUser":{"name":"mellowninja","email":"drazen@urch.eu"},"directories":{},"maintainers":[{"name":"muness217","email":"muness@gmail.com"},{"name":"mellowninja","email":"drazen@urch.eu"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/oh-mcp-server_0.3.2_1766970072106_0.44625987182170523"},"_hasShrinkwrap":false}},"time":{"created":"2025-12-26T22:09:26.529Z","modified":"2025-12-29T01:01:12.461Z","0.1.0":"2025-12-26T22:09:26.804Z","0.2.1":"2025-12-26T23:22:41.614Z","0.2.2":"2025-12-27T00:04:27.421Z","0.3.0":"2025-12-27T01:42:08.028Z","0.3.1":"2025-12-29T00:56:52.541Z","0.3.2":"2025-12-29T01:01:12.256Z"},"description":"MCP server for Open Horizons - enables AI agents to read/write alignment context","maintainers":[{"name":"muness217","email":"muness@gmail.com"},{"name":"mellowninja","email":"drazen@urch.eu"}],"readme":"# Open Horizons MCP Server\n\n[![npm version](https://badge.fury.io/js/@cloud-atlas-ai%2Foh-mcp-server.svg)](https://www.npmjs.com/package/@cloud-atlas-ai/oh-mcp-server)\n\nModel Context Protocol (MCP) server for [Open Horizons](https://app.openhorizons.me) - enables AI agents to read and write strategic alignment context.\n\n## What is This?\n\nOpen Horizons MCP Server connects AI coding assistants (like Claude Code) to your strategic alignment framework. Instead of making isolated technical decisions, AI agents can:\n\n- **Read your strategic context**: Query missions, aims, initiatives, and tasks\n- **Log decisions back**: Document why choices were made, tied to strategic goals\n- **Stay aligned**: Every code change traces back to a mission\n\n**The result:** AI that doesn't just code fast—it codes in alignment with your strategy.\n\n## Quick Start\n\n### 1. Get Your API Key\n\n1. Sign up at [app.openhorizons.me](https://app.openhorizons.me)\n2. Go to **Settings > API Keys**\n3. Create a new API key\n\n### 2. Choose Your Setup Method\n\n#### Option A: Plugin Setup (Recommended for Claude Code)\n\nThe plugin provides a guided `/oh-mcp:setup` command:\n\n```bash\n# Add the marketplace\nclaude plugin marketplace add cloud-atlas-ai/oh-mcp-server\n\n# Install the plugin\nclaude plugin install oh-mcp@oh-mcp\n\n# Restart Claude Code, then run:\n/oh-mcp:setup\n```\n\n#### Option B: Direct CLI Setup (No Plugin Needed)\n\nUse the `claude mcp add` command directly:\n\n```bash\nclaude mcp add oh-mcp -s user \\\n  -e OH_API_URL=https://app.openhorizons.me \\\n  -e OH_API_KEY=your_api_key_here \\\n  -- npx -y @cloud-atlas-ai/oh-mcp-server\n```\n\nThis adds the MCP server to `~/.claude.json` so it's available in all projects.\n\n#### Option C: Project-Specific Setup\n\nAdd to your project's `.mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"oh-mcp\": {\n      \"type\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@cloud-atlas-ai/oh-mcp-server\"],\n      \"env\": {\n        \"OH_API_KEY\": \"your_api_key_here\",\n        \"OH_API_URL\": \"https://app.openhorizons.me\"\n      }\n    }\n  }\n}\n```\n\n### 3. Verify\n\nRestart Claude Code, then ask Claude to test the connection:\n\n```\nTry calling: oh_about\n```\n\nIf it works, you'll see OH MCP tools available!\n\n## Available Tools\n\n### Read Operations\n\n- **`oh_get_contexts`** - List all contexts (personal and shared workspaces)\n- **`oh_get_endeavors`** - Get endeavors (missions, aims, initiatives, tasks) in a context\n- **`oh_get_endeavor`** - Get details of a specific endeavor with hierarchy\n- **`oh_get_logs`** - Get recent logs/decisions for an endeavor\n- **`oh_about`** - Get information about Open Horizons and this MCP server\n\n### Write Operations (Endeavors)\n\n- **`oh_create_endeavor`** - Create new mission, aim, initiative, or task\n- **`oh_update_endeavor`** - Update endeavor title and/or description\n- **`oh_archive_endeavor`** - Archive endeavor (soft delete)\n- **`oh_unarchive_endeavor`** - Restore an archived endeavor\n- **`oh_set_parent`** - Change parent of an endeavor (move in hierarchy)\n- **`oh_delete_endeavor`** - Permanently delete an endeavor\n\n### Write Operations (Logging)\n\n- **`oh_log_decision`** - Log decision, note, or progress to an endeavor\n- **`oh_update_log`** - Update a log entry's content\n- **`oh_delete_log`** - Delete a log entry\n\n### Write Operations (Candidates)\n\n- **`oh_create_metis_candidate`** - Surface a pattern/learning for later review\n- **`oh_create_guardrail_candidate`** - Surface a constraint/rule for later review\n\n### Write Operations (Contexts)\n\n- **`oh_create_context`** - Create new shared context (workspace)\n- **`oh_update_context`** - Update context title and/or description\n- **`oh_move_endeavor`** - Move endeavor to different context\n- **`oh_delete_context`** - Permanently delete a context\n- **`oh_invite_to_context`** - Invite user by email with role (editor or viewer)\n\n## Core Concepts\n\nOpen Horizons uses a four-level alignment hierarchy:\n\n```\nMission (why you exist)\n  └── Aim (outcome you want)\n       └── Initiative (how you'll achieve it)\n            └── Task (what you do today)\n```\n\n**Key Ideas:**\n- **Contexts**: Personal or shared spaces where endeavors live\n- **Endeavors**: Any node in the hierarchy (mission, aim, initiative, task)\n- **Decision logs**: Captured reasoning and progress tied to endeavors\n- **Alignment**: Every task traces back to a mission, so you always know *why*\n\n## Use Cases\n\n### 1. Strategic Coding with Claude Code\n\nInstall [superego](https://github.com/cloud-atlas-ai/superego) + OH MCP for metacognitive feedback tied to strategic context:\n\n```bash\n# Install superego (metacognitive advisor)\nclaude plugin marketplace add cloud-atlas-ai/superego\nclaude plugin install superego@superego\n\n# Install OH MCP (strategic alignment)\nclaude plugin marketplace add cloud-atlas-ai/oh-mcp-server\nclaude plugin install oh-mcp@oh-mcp\n\n# Restart Claude Code, then:\n/superego:init\n/oh-mcp:setup\n```\n\nNow Claude Code has metacognitive feedback (superego) tied to strategic context (OH MCP). Every decision gets logged back to your alignment framework.\n\n### 2. AI Swarm Coordination\n\nUse OH MCP in multi-agent systems to:\n- Fetch alignment packages before execution\n- Log decisions from each agent run\n- Maintain governance constraints across swarms\n- Create an audit trail of all AI decisions\n\nSee the [Swarm Alignment architecture](https://github.com/cloud-atlas-ai/open-horizons/blob/main/docs/ideas/swarm-alignment-mcp.md) for details.\n\n### 3. Custom AI Tools\n\nIntegrate OH MCP into your own AI tools:\n\n```typescript\nimport { Server } from '@modelcontextprotocol/sdk/server/index.js';\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';\n\n// Your MCP server can call OH API via the oh-mcp tools\n// to read context and log decisions\n```\n\n## Environment Variables\n\n- `OH_API_KEY` - Your Open Horizons API key (required)\n- `OH_API_URL` - OH API base URL (default: `https://app.openhorizons.me`)\n\n## Global Installation (Alternative)\n\nIf you prefer a global install over `npx`:\n\n```bash\nnpm install -g @cloud-atlas-ai/oh-mcp-server\n\n# Then use 'oh-mcp' command directly:\nclaude mcp add oh-mcp -s user \\\n  -e OH_API_URL=https://app.openhorizons.me \\\n  -e OH_API_KEY=your_api_key_here \\\n  -- oh-mcp\n```\n\n## Development\n\n```bash\n# Clone the repo\ngit clone https://github.com/cloud-atlas-ai/oh-mcp-server.git\ncd oh-mcp-server\n\n# Install dependencies\nnpm install\n\n# Build\nnpm run build\n\n# Run in dev mode\nnpm run dev\n\n# Test manually\nOH_API_KEY=your_key npm start\n```\n\n## Troubleshooting\n\n**\"API key invalid\"**\n- Verify your API key is correct\n- Make sure you're using a key from https://app.openhorizons.me/settings/api-keys\n\n**\"Connection failed\"**\n- Check that https://app.openhorizons.me is accessible\n- Verify your firewall/proxy isn't blocking the connection\n\n**\"MCP server not found\" or \"/oh-mcp:setup not recognized\"**\n- The `/oh-mcp:setup` command requires the plugin (see Option A above)\n- Without the plugin, use Option B or C for manual setup\n\n**\"MCP server crashed\"**\n- Check that the `dist/index.js` file exists (run `npm run build` if missing)\n- Look at Claude Code's MCP logs for error details\n- Try running manually: `OH_API_KEY=<key> npx @cloud-atlas-ai/oh-mcp-server`\n\n## Related Projects\n\n- **[Superego](https://github.com/cloud-atlas-ai/superego)** - Metacognitive advisor for Claude Code (pairs perfectly with OH MCP)\n- **[Open Horizons](https://app.openhorizons.me)** - The strategic alignment platform\n\n## License\n\nMIT License - see [LICENSE](LICENSE) for details.\n\n## Support\n\n- **Issues**: [GitHub Issues](https://github.com/cloud-atlas-ai/oh-mcp-server/issues)\n- **Email**: hello@cloudatlas.ai\n","readmeFilename":"README.md"}