Doubleoh MCP server

DoubleOh

The fix desk for AI agents.

When an agent reaches something it cannot do alone, a login, an approval, a rule nobody wrote down, one of your people takes over its screen for a minute. The fix compiles into a procedure with an explicit boundary of what the fleet may now do and what still needs a person. The next agent that hits the same wall follows the procedure, and you keep the record of who allowed what.

doubleoh.ai · Docs · Security

Run it yourself

One container. It carries the app, the API, the browser the agents drive, and its own PostgreSQL. Free for your own business under the Sustainable Use License.

git clone https://github.com/cheedli/doubleoh.git && cd doubleoh
cp .env.example .env        # fill it: every secret has its command next to it
docker compose up -d
open http://localhost:3001  # sign in with DOUBLEOH_ADMIN_EMAIL / DOUBLEOH_ADMIN_PASSWORD

Needs Docker, 4 GB of memory and an Anthropic key for the skill compiler. First pull is about 5 GB. Nothing leaves your network except the model calls you configure.

Putting it behind a domain, an external database, sizing and platform notes: docs/deployment.md. Every variable: docs/configuration.md.

What it does

wall, the learned skill comes back instantly with its authority boundary and nobody is paged.

1. An agent reaches its limit. It calls requestFix({ url, task }). If the fleet already knows this

fixer's hands. Typed text is never recorded; credentials and one-time codes stay with the person.

1. A person takes the wheel. A fix link opens the agent's live screen, browser or desktop, in the

transcript: numbered steps, a "Done when" line, and an authority field naming what still requires a human and what the agent must never do.

1. The fix becomes a bounded skill. A vision model reads the recording and writes a procedure, not a

what authority, before and after, what the fleet learned.

1. The record stays. Every fix has an exportable oversight record: who asked, who intervened, under

Skills are scoped to the customer and to the site they were learned on, stored in the open Agent Skills format, and retire themselves when they stop working.

Integrate in three calls

import { DoubleOh } from "@doubleoh/sdk";
const oo = new DoubleOh({ apiKey: process.env.DOUBLEOH_API_KEY, baseUrl: "http://localhost:3001" });

const skills = await oo.skillsFor(task, { url });   // what the fleet already knows here
const fix = await oo.requestFix({ url, task });      // a known wall, or a person
await oo.reportSkill(skill.name, worked);            // keeps the library honest

npm i @doubleoh/sdk · pip install doubleoh · MCP server: npx doubleoh-mcp.

Adapters for LangChain, LangGraph, CrewAI, LlamaIndex, the OpenAI Agents SDK, AutoGen, Pydantic AI, Browser Use and Mastra live in packages/. Any MCP-capable agent gets the three calls as tools with no code. Two complete example agents are in examples/.

Fixes on your own machines

The container covers public web pages. For an ERP, a Windows client or a staging portal, run the runtime natively on the machine that has them. It opens one outbound connection and listens on nothing. See docs/native-runtime.md.

What is in this repository

Shortened. The full README is on GitHub.