OATHERA

Bring Your Own Agent

Connect an Agent you already run to one hosted Combined MCP. You get one MCP URL and one bearer, shown once. Your Agent talks to the hosted Combined MCP directly; this page never sits in the middle of that session.

How it fits together

You run
Your Agent
any MCP client, outside the simulator
Hosted
Oathera MCP / Combined MCP
one Streamable HTTP /mcp URL
Behind it
Target Resource
sample or simulated, selected by the Combined MCP

Enrollment and every protected call use only the hosted Combined MCP URL. The first protected call returns an activation URL for the human step, the same as the other modes.

The Hosted Simulator holds no real third-party credential.

1 · Hosted Combined MCP: create one-time access

primary path
No access created yet.
The bearer is displayed exactly once. Copy the configuration now. If you reload or leave this page, the bearer is gone from this browser and from this server, and it cannot be shown again. To get a new one, create new access: that revokes the previous slot.

      

Streamable HTTP entry. Field names vary by client; the URL and the Authorization: Bearer header are what matter.

Expiry and limits.
  • A slot expires after 30 minutes idle and at most 2 hours after creation, whichever comes first. The expires_at shown after creation is the 2-hour maximum.
  • At most 3 slot creations per client address in a rolling hour, and at most 20 active Visitor Slots at once. Over a limit the server answers HTTP 429 slot_limit_reached.
  • Normal, BYOA and adversarial slots share the same limits.

2 · Example: OpenClaw as your external Agent

OpenClaw is an existing external Agent you can reach from Telegram, Discord, Slack, WhatsApp or the CLI. Register the hosted Combined MCP once, then delegate from any of those channels:

openclaw mcp add oathera-combined --transport streamable-http --url <mcp_url> --header "Authorization: Bearer <bearer>"

Replace <mcp_url> and <bearer> with the values from step 1. Then ask your Agent, from any channel:

Enrol me as an agent, then list my reports.

When the activation URL appears, open it and approve the sign-in as John Scully (john, john@northwind.example).

3 · Optional: your own real upstream MCPs

If you run your own Combined MCP, you can configure real upstream MCPs there. These blocks are placeholders only; the hosted simulator offers no real upstream.

Your own Combined MCP: one real upstream MCP over HTTP (placeholder)

{
  "upstreams": {
    "my-real-upstream": {
      "transport": "http",
      "url": "https://<your-upstream-mcp-host>/mcp",
      "headers": { "Authorization": "Bearer <YOUR_UPSTREAM_CREDENTIAL>" }
    }
  }
}

Customer-owned credential. You supply and own the real upstream credential and its secret handling. The Hosted Simulator holds no such credential and never receives it.

Your own Combined MCP: one real upstream MCP over stdio (placeholder)

{
  "upstreams": {
    "my-real-stdio-upstream": {
      "transport": "stdio",
      "command": "<your-upstream-mcp-command>",
      "args": ["<your-upstream-mcp-argument>"],
      "env": { "UPSTREAM_API_TOKEN": "<YOUR_UPSTREAM_CREDENTIAL>" }
    }
  }
}

Customer-owned credential. You supply and own the real upstream credential and its secret handling. The Hosted Simulator holds no such credential and never receives it.

The Hosted Simulator holds no real third-party credential.

4 · Download: split-role local development

split-role local development

The downloadable bundle is split-role local development. It contains two stdio servers (an Identity MCP and a Gateway MCP) and a sample Resource Server that you run on your own machine. It is not the hosted Combined MCP and does not replace step 1.

⤓ Download split-role bundle (.tar.gz) Identity MCP + Gateway MCP + Resource Server, with a README and prefilled config.
tar -xzf oathera-mcp-bundle.tar.gz && cd oathera-mcp-bundle
npm install
npm run start

OpenClaw registration for the two local servers:

Loading the OpenClaw instructions…