Dreambooth Documentation

Connect Dreambooth to ChatGPT, Claude, or Gemini

Dreambooth publishes an MCP (Model Context Protocol) server. Connect it once and you can ask an AI assistant about your own booths in plain language:

"How much did my booths make last week?" "Which project ran the most sessions in August?" "How many credits do I have left?"

The assistant reads your live Dreambooth data and answers from it. You do not copy numbers out of the dashboard, and you do not export a spreadsheet first.

What you need

  • A Dreambooth account (any plan, including Free).
  • An AI assistant that supports MCP connectors — ChatGPT, Claude, or Gemini. The exact menu differs per app; look for Connectors, Integrations, or Custom MCP server.

Connect it

  1. In ChatGPT, Claude, or Gemini, find the connector or integration settings and choose to add a custom MCP server.

  2. Use:

    https://mcp.dreamboothstudio.com/mcp
    

    Nothing else to fill in — no API key, no token, no client secret. The connector discovers everything else it needs on its own.

  3. The assistant opens a Dreambooth sign-in page. Log in with the account that owns your booths, then approve the request. The approval screen names exactly one permission: read your booth data.

  4. Back in the assistant, ask a question about your booths. A good first test is "list my Dreambooth projects" — if the projects come back, you are connected.

What you can ask

Available to the assistant once connected

AreaAccessWhat it covers
Your projectsRecommendedList every project, and open one to see its status, currency and settings.
SessionsRecommendedFilter by date, project, payment status, payment source, promo or voucher code.
RevenueRecommendedSummaries by period and by project, in the currency the project charges in.
WalletStableBalance, lifetime earnings, and recent wallet transactions. Read-only — no withdrawals.
CreditsStableHow many AI credits remain on the account.
GalleryStableCounts of galleries, photos, videos and strips over a period.
DocumentationRecommendedSearch these docs, so the assistant answers setup questions from the real manual instead of guessing.

Questions that work well

Assistants are better at some shapes of question than others. These work reliably:

  • "Compare revenue between my projects for July and August."
  • "Which of my booths had no sessions at all last week?"
  • "How many sessions were paid by QRIS versus voucher this month?"
  • "What's my wallet balance and when were the last three transactions?"
  • "According to the Dreambooth docs, which printers are recommended for 4R?"

Questions the connector cannot answer, because it cannot write or reach those surfaces: creating projects, editing frames or filters, issuing vouchers, changing prices, requesting a withdrawal, or anything about another operator's account.

Security

  • Authorization uses OAuth 2.1 with PKCE. No password is ever given to the assistant, and no long-lived API key is created.
  • The only granted scope is booths:read.
  • Withdrawals, payout accounts, and admin surfaces are not exposed at all.

Troubleshooting

The assistant says it cannot reach the server.

Check the URL is exactly https://mcp.dreamboothstudio.com/mcp, including the trailing /mcp. Opening that address in a normal browser tab will not show a web page — it is an API endpoint, and a browser visit returning an error is expected, not a fault.

I connected, but it says I have no projects.

You are probably signed in with a different account from the one that owns the booths — for example a personal email instead of the studio email. Disconnect the connector, then reconnect and sign in with the owner account.

Can I give my staff access this way?

Only through their own Dreambooth login. Each person connects with their own account and sees exactly what their collaborator permissions already allow them to see in the dashboard. Do not share one login between people.

How do I disconnect it?

Remove the connector in your assistant's settings. Access stops immediately — the token is bound to that connection, not to your Dreambooth password.

Does it cost anything?

No. The connector is included on every plan, including Free, and reading your data through it does not consume AI credits.

Last updated: