Docs

Use VibeBot from Claude or Lovable

Add VibeBot to an AI app with one URL. Then ask about your bot in plain words.

The connector URL
https://www.vibebot.gg/api/mcp
Connecting apps needs Pro. A Pro trial counts.

What you can do

  • Ask for your bot's status, and for the top members by coins, XP or any other number.
  • Look up one member's data.
  • Give or take coins, or fix one member's data, when you allow changes.
  • Have an app builder learn how your app's server reads bot data.

Connect from claude.ai or Claude Desktop

  1. In Claude, add a custom connector. Paste the connector URL.
  2. Sign in to VibeBot when Claude asks.
  3. Under Choose bots, tick the bots Claude can reach.
  4. Tick Allow changes only if Claude can change member data. It is off by default.
  5. Click Connect.

Connect from Claude Code

Run this command in your terminal:

Terminalbash
claude mcp add --transport http vibebot https://www.vibebot.gg/api/mcp

Then, in Claude Code, run /mcp, pick vibebot, and sign in to VibeBot in your browser. Tick the bots and Allow changes as in the claude.ai steps.

Lovable and other apps

Any app that adds MCP connectors can use the same URL. The app signs you in to VibeBot. Follow the claude.ai steps. API keys do not work with the connector.

An app other than Claude shows Unverified app on the VibeBot page. Connect it only if you started the connection yourself.

In Lovable, the connector helps while Lovable writes your dashboard. The finished dashboard reads your bot with an API key on its own server. See Connect a web app.

Tools

The app sees these tools. The change tools show only when the connection has data:write.

ToolScopeWhat it does
list_botsAnyLists the bots this connection reaches.
get_bot_statusstatus:readShows a bot's status and last heartbeat.
list_data_typesdata:readLists the data types a bot saves in one server.
read_datadata:readReads the top rows of one data type, like a leaderboard.
read_memberdata:readReads one member's row.
set_member_datadata:writeSets one member's row.
increment_member_datadata:writeAdds to or takes from one number, like coins.
clear_member_datadata:writeClears one member's row.
get_api_guideAnyExplains how an app's server calls the owner API.

Access and safety

  • Your bots only: an app reaches only the bots you ticked. A bot you add later is not included. To add it, connect again.
  • Allow changes: off by default. Without it, the app can only read. With it, the app can set, add to and clear member data. It cannot change bot settings.
  • Recent writes: each change shows under Recent writes in your bot's API keys, with the app's name.
  • Disconnect: open Settings, then Connected apps, and click Disconnect. The app loses access at once.

Limits

  • An app shares your bot's request limits with your API keys. If it hits a limit, wait a minute, then ask again.
  • An app reads at most 100 rows at a time.
  • An app cannot change bot settings, build, deploy or make API keys.
  • A sign-in ends after 30 days without use. Then sign in again.

Troubleshooting

  • 401: sign in again. The sign-in ended, or you disconnected the app.
  • 403: your account has no Pro, or the account is frozen.
  • The app cannot find a bot: you did not tick it. Connect again and tick it.
  • The app cannot change data: connect again with Allow changes on.
  • 429: a limit was hit. Wait a minute, then try again.

Next steps