Botsona in your AI assistant.

Ask ChatGPT, Claude, Perplexity or your coding agent to test your website. Botsona's AI testers try it as first-time users in a cloud sandbox, and your assistant brings back what to fix first.

What it does

Botsona is an MCP server, the standard way AI assistants use outside tools. Once it is connected, a test is one sentence away.

  1. You ask, for example: "Can a first-time user buy 2 tickets on tickets.example.com?"
  2. Your assistant starts a Botsona test and gives you a link to watch it live.
  3. AI testers, each on their own device, try the task in a cloud sandbox while Botsona keeps recorded evidence of every step.
  4. When the test ends, your assistant reads you the report: the headline, what to fix first and the findings, with a link to the full report.

Set it up

Every client uses the same address. When your assistant asks, sign in with your Botsona account and choose Allow. No API key is needed.

https://app.botsona.io/mcp

Chat assistants

ChatGPT

Needs developer mode

Turn on developer mode in Settings, Security and login, then add a custom MCP server with the address and OAuth.

Open ChatGPT apps

Claude

Web and desktop, paid plans

Settings, Connectors, Add custom connector, then paste the address.

Open Claude connectors

Perplexity

Paid plans with custom connectors

  1. Account settings, Connectors, + Custom connector, then choose Remote.
  2. Name it Botsona and paste the address as the MCP Server URL. Choose OAuth and Streamable HTTP.
  3. Tick the acknowledgement, choose Add, then open the Botsona card to sign in.
Open Perplexity connectors

Coding agents and editors

Claude Code

Then run /mcp to sign in

claude mcp add --transport http --scope user botsona https://app.botsona.io/mcp

Codex

Opens a browser to sign in

codex mcp add botsona --url https://app.botsona.io/mcp

If no browser opens, run codex mcp login botsona.

Cursor

Opens Cursor to add it

Or add "botsona": {"url": "https://app.botsona.io/mcp"} under "mcpServers" in ~/.cursor/mcp.json.

Add to Cursor

Any other client: add the address the way it supports remote MCP servers.

The five tools

Your assistant picks the right one from what you ask.

Start a teststart_test
Starts a task test, where AI testers try one thing you describe, such as signing up. Leave the task out for a full-site scan. Returns a link to watch it live and uses your plan's credits.
Get a testget_test
Says whether a test is waiting, running or done and the credits it used. Once it is done: the headline, summary, what to fix first and the findings, with a link to the full report.
List testslist_tests
Your most recent tests, newest first, with each one's site, task, status and summary.
Stop a teststop_test
Stops a running or waiting test and keeps whatever the testers found so far. A stopped test can't be resumed, so your assistant asks you first.
Plan and creditsget_account
Your plan, the credits left this week and any you bought, when the weekly credits reset, and how many testers a test can use.

Things to ask

  • "Have Botsona test the new sign-up flow on our preview."
  • "Can a first-time user buy 2 tickets on tickets.example.com? Tell me what to fix first."
  • "Run a full-site scan of example.com with Botsona."
  • "How is my Botsona test going?"
  • "List my last five Botsona tests and what failed in each."
  • "How many Botsona credits do I have left this week?"

Limits

  • Public websites only, and only sites you own or may test.
  • Up to 3 tests at once and 20 a day per account. Extra tests wait their turn.
  • A task test runs for up to 20 minutes, a full-site scan for up to 30.
  • Up to 180 requests a minute per account.
  • Tests use your plan's credits, the same as tests started in the app. See pricing.
  • Streamable HTTP with MCP protocol versions 2025-11-25, 2025-06-18 and 2025-03-26.

The Botsona skill

For coding agents: the skill teaches your agent when to run a test, how to word the task, how long to wait, and how to report what to fix first. Paste this prompt into Claude Code, Codex, Cursor or another coding agent. It adds Botsona and the skill, then asks you to sign in once.

Set up Botsona (AI usability testing) for me.

1. Add the Botsona MCP server. URL: https://app.botsona.io/mcp (streamable HTTP, OAuth sign-in, no API key).
   - Claude Code: run `claude mcp add --transport http --scope user botsona https://app.botsona.io/mcp`
   - Codex: run `codex mcp add botsona --url https://app.botsona.io/mcp` (it opens a browser to sign in; if it does not, run `codex mcp login botsona`)
   - Cursor: add "botsona": {"url": "https://app.botsona.io/mcp"} under "mcpServers" in ~/.cursor/mcp.json
   - Any other agent: add it to your MCP configuration the way you support remote servers.

2. Install the Botsona skill. Download https://app.botsona.io/skills/botsona/SKILL.md and save it unchanged as SKILL.md in a folder named botsona in your skills directory:
   - Claude Code: ~/.claude/skills/botsona/SKILL.md
   - Codex: ~/.codex/skills/botsona/SKILL.md
   - Cursor: .cursor/rules/botsona.mdc in this project
   - Any other agent: wherever you keep skills or standing instructions.

3. Tell me what you changed, and how to sign in to Botsona (a browser window opens; I sign in with my Botsona account and click Allow). After I have signed in, check it works by asking Botsona how many credits I have left.
View SKILL.md

Questions

Do I need an API key?

No. Your assistant opens a Botsona page, you sign in with your Botsona account and choose Allow. The address is all you paste.

Does it cost extra?

No. Tests started from an assistant use your plan's credits, like tests started in the app. The Free plan has 60 credits a week.

Can it test localhost or a private staging site?

No. Testers reach only public websites. A preview or staging address works when anyone on the internet can open it.

Can I still watch the test?

Yes. Every test comes with a link to watch it live in the Botsona app, with the recordings and the full report when it ends.

How do I disconnect Botsona?

Remove Botsona from the connectors, apps or MCP servers in your assistant's settings. Your tests stay in your Botsona account.