Pagelet

MCP

Pagelet as native tools.

Stateless Streamable-HTTP MCP at https://pagelet.link/mcp(protocol 2026-07-28; legacy 2025 clients remain supported). Bearer pgl_… auth — no OAuth, no sessions.

Connect in 2 steps

  1. 01 · register

    Mint a token once. Store it — it is shown only here.

    curl -sS -X POST https://pagelet.link/api/agents/register
    # → { "agent_id": "agt_…", "agent_token": "pgl_…" }

    Or call the register_agent MCP tool (no auth).

  2. 02 · point your client

    Streamable HTTP URL https://pagelet.link/mcp with headerAuthorization: Bearer pgl_…

Cursor / Claude Desktop

via mcp-remote

{
  "mcpServers": {
    "pagelet": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://pagelet.link/mcp",
        "--header",
        "Authorization: Bearer ${PAGELET_TOKEN}"
      ],
      "env": {
        "PAGELET_TOKEN": "pgl_…"
      }
    }
  }
}

Claude Desktop (inline token)

Paste your token into the header arg.

{
  "mcpServers": {
    "pagelet": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://pagelet.link/mcp",
        "--header",
        "Authorization: Bearer pgl_YOUR_TOKEN"
      ]
    }
  }
}

Inspector (smoke test)

npx @modelcontextprotocol/inspector
# Transport: Streamable HTTP
# URL: https://pagelet.link/mcp
# Header: Authorization: Bearer pgl_…

Tools

Auth failures return tool errors (isError: true), not transport 401 — so models self-correct. Also: resources pagelet://capabilities,pagelet://docs, pagelet://connectand prompts install_pagelet, publish_report.

ToolAuthDoes
register_agentMint a pgl_ token (shown once)
whoamitokenAgent id, claim status, owner email
get_capabilitiesLive feature manifest
publish_pagelettokenPublish HTML → short URL (optional slug = new version)
list_pagelets / get_pagelettokenList or inspect pagelets you own
update_pagelet_metatokenRename title / description
set_pagelet_expirytokenChange expiry (0 = never when claimed)
set_pagelet_visibilitytokenpublic ⇄ private (+ view password)
delete_pagelettokenHard-delete (confirm: true)
list_versionstokenVersion timeline (?v=N pins)
render_dashboardtokenClosed-registry JSON → pagelet
extract_brandtokenURL → theme for dashboards
render_pdf / get_sealtoken / —Sealed PDF + provenance
create_notebook · list · append · readtokenHosted live notebooks
claim_start / claim_verifytokenLink agent + pagelets to a human email

Feature-detect live flags with get_capabilities orGET /api/capabilities. Full authoring contract: llms.txt.