oh

This MCP server provides a bridge between AI agents and Open Horizons' strategic alignment data. It exposes a set of read operations (oh_get_contexts, oh_get_endeavors, oh_get_endeavor, oh_get_logs, oh_about) to query contexts, missions, aims, initiatives, tasks, and related logs, and a suite of write operations (create/update/archive/unarchive/delete for endeavors, log entries, and context management) to capture decisions and evolve the strategic structure. Tools are designed to be invoked by Claude Code or integrated into custom AI toolchains, enabling agents to read the current alignment, log their decisions with justification, and maintain a clean audit trail that ties every action back to a mission.

To use the server, first set up authentication and connect via the MCP client (for example through Claude Code or your own integration). You can add the server via npx or a project configuration, then call tools like oh_get_contexts to discover available contexts, oh_get_endeavors to fetch the hierarchy within a context, and oh_log_decision to attach reasoning to a specific endeavor. The environment variables OH_API_KEY and OH_API_URL secure and direct the server to your Open Horizons instance. If you’re using Claude Code, you can follow the Quick Start options to install via the plugin marketplace or the direct CLI, then verify the connection by invoking oh_about and checking available tools.

Prerequisites:

• Node.js and npm installed on your machine (Node.js 14+ recommended)
• An Open Horizons API key (OH_API_KEY) and base URL (OH_API_URL, defaults to https://app.openhorizons.me)

Option 1: Run with npx (no local install)

1. Obtain your API key from app.openhorizons.me/settings/api-keys
2. Run the MCP server via npx:

npx -y @cloud-atlas-ai/oh-mcp-server

Note: If you want to preset environment variables, you can prepend them when invoking the command in your environment:

OH_API_KEY=your_api_key_here OH_API_URL=https://app.openhorizons.me npx -y @cloud-atlas-ai/oh-mcp-server

Option 2: Local installation

1. Install dependencies and build (if applicable):

npm install
npm run build

2. Run in development mode (or production as configured):

npm run dev

Option 3: Global installation (alternative)

1. Install globally:

npm install -g @cloud-atlas-ai/oh-mcp-server

2. Add to Claude or your CLI workflow as described in the docs, for example using the global command or via npx as shown in Option 1.

• Ensure OH_API_KEY has the correct permissions for reading contexts and writing logs.
• OH_API_URL should point to the OH instance you want to integrate with; the default is https://app.openhorizons.me.
• If you encounter API key or connection errors, verify the key in the Open Horizons settings and ensure network access to the OH API endpoint.
• The MCP server supports multiple operations; use oh_about to confirm the server is reachable and to inspect available endpoints.
• For Claude Code integration, you can use the Quick Start setup (plugin or direct CLI) to register the MCP and then run the /oh-mcp:setup command to finalize configuration.