[ PROTOCOL // COGNITIVE_GATEWAY ]

Connect the Maha Cognitive Gateway to Claude

This guide connects the hosted Cognitive Gateway to Claude Desktop over MCP.

Published on Smithery as mayone/cognitive-gateway, the gateway supports Maha OS telemetry, publishing workflows, and bounded governance tooling from the Claude desktop context.

STATUS: OPERATIONAL

Access requires a token. The hosted gateway is separate from the local commercial Maha MCP Bridge; credentials are not interchangeable.

[ Bring telemetry and publishing into your assistant ]

Use this path for read-first tools and policy-enforced actions from Claude. Request a token, add the config block, restart, and verify.

Request an access token ↗

[ 00 ] Prerequisites

Node.js and npm installed (so npx is available)
Claude Desktop app
Maha Cognitive Gateway access token

[ 01 ] Get an access token

The gateway requires a token. Request one via the contact page. Replace YOUR_TOKEN in the config block with your live token.

[ 02 ] Add the server in claude_desktop_config.json

In Claude Desktop open Settings → Developer → Edit Config, add the entry below to mcpServers.

{
  "mcpServers": {
    "maha-os": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.maha-os.com/mcp",
        "--header",
        "Authorization: Bearer YOUR_TOKEN"
      ]
    }
  }
}

*On first run, npx pulls mcp-remote and bridges to https://mcp.maha-os.com/mcp.

[ 03 ] Restart and verify

Fully quit Claude Desktop (Cmd+Q), reopen it, and start a new conversation. Confirm maha-os appears in your tool list. If nothing appears, go directly to troubleshooting.

[ 04 ] Available tools

defense_get_baseline

Reads live biometric telemetry. Returns UNLINKED unless the Maha OS mobile client is bridged.

defense_trigger_circuit_breaker

Sends a cognitive-defense intervention to a linked device. Write action — approval required.

publish_analyze_mswl

Scores a literary agent’s wishlist against the manuscript and suggests a hook.

publish_generate_query

Drafts a tailored query letter from the book proposal and author dossier.

publish_log_query

Logs a query submission to the tracking file. Write action.

publish_export_shunn

Formats a chapter into Shunn manuscript standard.

publish_fetch_sovereign_data

Retrieves author dossier and proposal data by manuscript ID.

publish_synthetic_market_audit

Audits a manuscript framework against market and discourse trends.

[ 05 ] Test prompt

A useful first test should be server-only and deterministic. Ask Claude:

“Use the Maha synthetic market audit tool on this proposal: ‘A framework for biological sovereignty and attentional defense in the age of algorithmic capture.’”

If Claude answers from general knowledge instead of making a tool call, the MCP route is not active. See troubleshooting.

[ 06 ] Troubleshooting

Tools do not appear: fully quit and reopen Claude Desktop; verify JSON is valid and no trailing commas exist.
Auth errors: check Authorization: Bearer <token> is correctly set.
Calls fail: verify network, token, and config before retrying.
Command not found: confirm Node/npm install and PATH.

[ 07 ] Sources and governance references

Source and README ↗Smithery listing ↗Back to Research ↗