unbrowse

Connect your assistant.

Bring your websites into the conversation you’re already having. Choose an assistant to get started.

Which assistant do you use?

Connect another assistant

  1. Open your assistant’s connection settings.

    Look for an option to add a remote MCP server. Your assistant must support remote connections and OAuth sign-in. If it does not, check the developer options below.

  2. Name it Unbrowse and add this connection address.

    https://unbrowse.ai/mcp

  3. Sign in to Unbrowse and review access.

    Your assistant will open the sign-in flow. Use the same Unbrowse account where you keep your connected websites. Finish the approval, then return to your assistant.

Developer options

Try your first request.

In a new conversation, enable Unbrowse and paste this request. It uses a public site, so you don’t need to connect another account.

Use Unbrowse to find the top stories on Hacker News. Include links to the originals.

Check that you receive stories with source links. If Unbrowse is unavailable, check that the connection is enabled. To use a private account, manage your saved logins.

For developers: CLI, MCP and API options

  1. 01 · Agent Skill

    SKILL.md

    Thin public wrapper. Drop it in any skill-capable agent. YAML harnesses surface as searchable skills; Private space ranks first.

    npx skills add unbrowse-ai/unbrowse

  2. 02 · Remote MCP

    Hosted harness

    Add it to your agent in one step. Every client signs in with OAuth — approve once on unbrowse.ai, nothing to paste.

    Server URL

    https://unbrowse.ai/mcp
    Add to Cursoropens Cursor, then ConnectAdd to VS Codeopens VS Code, then AllowVS Code Insiderssame, Insiders build

    Claude Code

    claude mcp add --transport http unbrowse https://unbrowse.ai/mcp

    Then run /mcp and pick Authenticate.

    Codex

    codex mcp add unbrowse --url https://unbrowse.ai/mcp && codex mcp login unbrowse

    The login opens your browser once.

    Claude (web and desktop)

    Settings → Connectors → Add custom connector. Paste the server URL, then Connect.

    ChatGPT

    Settings → Apps & Connectors → Create (developer mode). Paste the server URL, authentication OAuth.

    Any other MCP client (JSON)
    {
  "mcpServers": {
    "unbrowse": {
      "url": "https://unbrowse.ai/mcp"
    }
  }
}

    Every client signs you in with OAuth: you approve it once on unbrowse.ai and it gets its own revocable access. No key to paste; your saved logins stay in your vault.

    Or with an API key

    For clients without OAuth, scripts and servers.

    {
  "mcpServers": {
    "unbrowse": {
      "url": "https://host/mcp",
      "headers": { "Authorization": "Bearer ub_live_…" }
    }
  }
}

  3. 03 · TypeScript SDK

    The product is the SDK

    MCP is an adapter. REST lives at /api/v1. First request is fulfilled while Unbrowse passively indexes the route.

    import { Unbrowse } from "@unbrowse/sdk";

const ub = new Unbrowse({
  apiKey: process.env.UNBROWSE_API_KEY!,
  baseUrl: "https://host/api/v1",
});

const run = await ub.run({ task: "top stories on Hacker News" });

Private space (sites you connected, public or passworded) always ranks above the public registry. Full skill text stays at /skill/SKILL.md.