oracle-h-mcp

> Human-on-the-Loop validation for autonomous AI agents — via Model Context Protocol

[](https://www.npmjs.com/package/oracle-h-mcp) [](https://www.npmjs.com/package/oracle-h-mcp) [](https://smithery.ai/server/@tponscr-debug/oracle-h-mcp) [](https://opensource.org/licenses/MIT)

ORACLE-H is a safety infrastructure that acts as a mandatory checkpoint for autonomous AI agents. Before executing any critical, destructive, or irreversible action, the agent submits it for human approval via Telegram. The human decides with a single tap.

Agent → oracle_validate → Human gets Telegram alert → Approve/Reject → Agent proceeds

Without ORACLE-H: 4-step workflow succeeds ~81.5% of the time. With ORACLE-H: Same workflow succeeds ~99.6% of the time.

| Tool | Description | |------|-------------| | oracle_validate | Submit a risky action for human approval. Returns a request_id. | | oracle_poll_status | Poll the decision until approved, rejected, or expired. |

# Test immediately with the public demo key
ORACLE_SIGNATURE_KEY=demo-signature-key-change-in-production
ORACLE_BASE_URL=https://oracle-h.online

---

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "oracle-h": {
      "command": "npx",
      "args": ["-y", "oracle-h-mcp"],
      "env": {
        "ORACLE_SIGNATURE_KEY": "<your-signature-key>",
        "ORACLE_BASE_URL": "https://oracle-h.online"
      }
    }
  }
}

Add to your MCP settings:

{
  "oracle-h": {
    "command": "npx",
    "args": ["-y