Pagelet/ docs
Docs menu

OpenClaw

Publish, list and seal pagelets from OpenClaw agents.

OpenClaw's MCP registry takes streamable-HTTP servers with static headers — full Pagelet tool access.

Configure

Register a token first (one curl call), then add the server via the CLI:

add + probe
openclaw mcp add pagelet \
  --url https://pagelet.link/mcp \
  --transport streamable-http \
  --header "Authorization: Bearer pgl_…"
openclaw mcp doctor pagelet --probe

Or write it straight into ~/.openclaw/openclaw.json under mcp.servers (the Control UI's Settings → MCP page has a scoped editor for the same block):

~/.openclaw/openclaw.json
{
  "mcp": {
    "servers": {
      "pagelet": {
        "url": "https://pagelet.link/mcp",
        "transport": "streamable-http",
        "headers": {
          "Authorization": "Bearer pgl_…"
        }
      }
    }
  }
}

openclaw mcp doctor warns about literal secrets in headers — OpenClaw redacts them in logs, but keep openclaw.json out of version control.

Verify it works

  • openclaw mcp probe pagelet — opens a live connection and lists Pagelet's tools.
  • openclaw mcp status --verbose — shows the resolved transport and header config without connecting.
  • Already-running Gateway/agent processes may need openclaw mcp reload (same process) or a restart to pick the server up.

First pagelet

In a session, ask: "Make a pagelet status report for this week and publish it." The agent callspublish_pagelet and returns a https://<slug>.usepagelet.com URL — open it to confirm.

Troubleshooting

  • "Auth required" tool errors — header missing/wrong; check with openclaw mcp show pagelet and re-add.
  • Server in Settings but no tools — run openclaw mcp doctor pagelet --probe; also check no toolFilter is excluding everything.
  • Agent doesn't see it mid-session — the runtime cached its catalog; openclaw mcp reload or restart the owning process.
  • Empty tool list — confirm the URL and /api/capabilities (service.mcp).

Sources: Connect MCP servers andMCP CLI reference (transport + headers verified there).