Wysebee

Docs

Wysebee Assistant MCP server

Add Wysebee to Claude or ChatGPT as a custom connector. Your AI app signs in to your Wysebee account and can then use your agents, their tools and your tasks.

Overview

Wysebee Assistant is a remote MCP server run by Wysebee Cloud. One connector gives your AI app every Wysebee agent you leave on: an agent paired with your Chrome browser, one paired with your Mac, and agents that live in the cloud with skills and database connections.

Wysebee runs no model of its own. Claude or ChatGPT does the thinking and calls Wysebee's tools; Wysebee carries out each call with the agent and tool you asked for.

You need a free Wysebee account. Sign in once at app.wysebee.com to create it.

Server details

Server URL
https://app.wysebee.com/assistant/mcp
Name
Wysebee Assistant (wysebee-assistant)
Transport
Streamable HTTP, stateless (no session)
Authentication
OAuth 2.1 with your Wysebee account. The server answers 401 with protected-resource metadata (RFC 9728) pointing at Wysebee's sign-in, so your AI app starts the sign-in for you.
Scopes
openid profile email offline_access
MCP protocol versions
2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05
Who can use it
Anyone with a free Wysebee account. Each sign-in reaches only that account's agents.

Connect Claude

  1. In Claude, open Settings → Connectors and choose Add custom connector.
  2. Name it Wysebee and paste https://app.wysebee.com/assistant/mcp as the URL. Leave the OAuth client fields empty.
  3. Click Connect and sign in with your Wysebee account in the window that opens.
  4. In a chat, turn the Wysebee connector on from the tools menu and ask, for example, “List my Wysebee agents”.

On a Team or Enterprise plan, an owner may need to add the connector for the organization first.

Connect ChatGPT

  1. In ChatGPT, open Settings → Apps & Connectors and choose Create. Developer mode may need to be turned on under Advanced settings.
  2. Name it Wysebee, paste https://app.wysebee.com/assistant/mcp as the MCP server URL and choose OAuth for authentication.
  3. Create it and sign in with your Wysebee account when asked.
  4. In a chat, add Wysebee from the + menu and ask it to use one of your agents.

Tools

Read-only tools are marked as such to your AI app, so it can tell them from tools that change something.

Agents

Your Wysebee agents, Wysebee itself among them. Each agent has the tools you gave it: a paired browser, a paired Mac, skills, database connections.

  • list_agentsread-only

    Lists your agents: each one's @handle, name, what it is for and whether it drives a browser.

  • list_agent_toolsread-only

    One agent's tools, with what each does, its input schema and whether it is read-only, plus your notes on that agent.

  • call_agent_read_toolread-only

    Runs one of an agent's read-only tools and returns its result, text and pictures: reading a browser page or taking a screenshot, reading a file in your folders or a skill, listing tables or querying a database. It changes nothing: a SQL query runs read-only here, even on a connection that allows changes.

  • call_agent_tool

    Runs one of an agent's tools that act and returns its result, text and pictures: clicking or typing in your browser, a program or script on your Mac, writing a file, sending a notification, or a SQL statement that changes data where the connection allows it. It runs only tools that act; read-only ones go through call_agent_read_tool. A browser agent's tools act in your own browser through the Wysebee Agent extension, which may ask you first.

Tasks

Reminders and scheduled work that Wysebee Cloud runs when due. Results show on the Activity page.

  • list_tasksread-only

    Your tasks, with schedule, next run, plan and steps.

  • save_task

    Creates a task or changes one: a reminder, or up to a few agent tool calls run in order, once or on a schedule.

  • run_task

    Runs a task now, whatever its schedule.

  • delete_task

    Deletes a task so it no longer runs.

Projects editor

Available while you have a page open with Wysebee Assistant on in Wysebee's Projects editor. Edits appear in your editor at once and are not saved until you click Save.

  • read_documentread-only

    The open page's text, unsaved edits included.

  • write_document

    Replaces the whole page.

  • append_to_document

    Adds text at the end of the page.

  • replace_in_document

    Replaces one passage that appears exactly once.

  • list_project_filesread-only

    The project's saved files.

  • read_project_fileread-only

    One saved file of the project.

Skills

Skills are folders of instructions, and optional scripts, that you give your agents.

  • create_skill

    Creates a new skill and opens its SKILL.md in your editor.

  • list_skill_filesread-only

    The open skill's files and folders.

  • read_skill_fileread-only

    One file of the open skill.

  • write_skill_file

    Adds or replaces a file in the open skill, such as a script or template.

  • add_skill_folder

    Makes a folder in the open skill.

Permissions and safety

  • A sign-in reaches only the agents, tasks and pages of that Wysebee account.
  • An agent's tools that only look run through call_agent_read_tool, which is marked read-only, so your AI app can run them without asking each time. Tools that act run only through call_agent_tool, which is marked as one that changes things, so your AI app asks you before each call.
  • You choose which agents your AI app can use: each agent has a switch under Connect AI app in Wysebee Cloud. An agent turned off is neither listed nor run.
  • An agent can only use the tools you gave it. The Wysebee Agent extension still decides, per site and per action, what runs in your browser, and asks you first on sites you have not trusted. Wysebee Agent for Mac does the same for programs, folders and scripts.
  • Changes to a page in the Projects editor are not saved until you click Save.
  • To disconnect, remove the connector in your AI app. You can also turn every agent off for AI apps in Wysebee Cloud.

Data and privacy

Tool calls and their results pass through Wysebee Cloud to reach your agents and are not kept after the call. What your AI app does with a result is governed by that app's own policies. A folder picture that Wysebee Agent for Mac shows for your eyes only is not passed to the AI app.

Your agents, tasks, skills and projects are kept in your Wysebee account as described in the Privacy Policy. Use of the server is subject to the Terms of Service.

Usage and credits

Each tool call that is answered uses one Wysebee credit: call_agent_read_tool, call_agent_tool and the Projects editor tools. list_agents and list_agent_tools are free, and a call that is refused, fails or times out is not counted.

Troubleshooting

My AI app says it cannot connect or sign in.
Check the URL is exactly the one above, with no trailing slash. Remove the connector and add it again, then finish the Wysebee sign-in in the window your AI app opens. Sign in with the same account you use at app.wysebee.com.
An agent is missing from list_agents.
It may be turned off for AI apps. In Wysebee Cloud, open the agent, go to Connect AI app and turn on “Let your AI app use this agent”.
A browser tool times out or says the browser is not connected.
The browser paired with that agent has to be open, with the Wysebee Agent extension connected. If the extension is waiting for your approval, answer it in the side panel. A call that runs longer than about four minutes is stopped and reported as timed out.
The document tools say no page is open.
Open the page in Wysebee's Projects editor and turn Wysebee Assistant on for it, then ask again.

Support

Email support@wysebee.com or ask in the Wysebee Discord, where questions get answered and bugs get reported.