Bloss Docs

Use your data with AI agents

Connect an AI agent such as Claude to your Bloss data and ask it about your earnings, payouts, videos, views and bounties. Free for every creator.

Creators

You can let an AI agent, such as Claude, read your Bloss data and answer questions about it in plain language: what you've earned, how your videos are doing, which bounties are open. If you write code, you can read the same data through the Bloss API instead. Both are free, and both are read-only: nothing in your account can be changed through them.

What you can ask

Here are some questions an agent can answer, and the data it reads to answer them.

AskThe agent reads
"How much have I earned across all my brands, and how much is still pending?"Your earned, paid and pending totals per brand, as on each brand's Payouts page.
"Break down my last three payouts in Glow Skincare into base and bonus."Your payouts in that brand, one per payout cycle.
"Did I earn any referral bonuses this month?"Your referral payouts.
"Is my payout account set up in every brand?"Your payout setup in each brand, with details masked.
"Which of my videos got the most views this week?"Your videos in a brand, with views, likes, comments, shares and saves, and the set each belongs to.
"Chart my views per day in Glow Skincare for the last 30 days."Your daily views in that brand, in the brand's time zone.
"Which platform brings me the most views overall?"Your stats across all brands, per platform.
"Which bounties can I still claim, and what do they pay?"The brand's open bounties, with rewards, deadlines, slots left and your own claims.
"How many videos a week does Glow Skincare expect from me?"The brand's posting rules for creators.
"Where do I stand in Streak Survivor?"The brand's active game and your standing in it.

Earnings and payouts are money data: the agent can read them only if you give its token the Money data permission. Everything else works without it.

Set it up

Create an API token

Go to AccountAPI tokens and click Create token. Tick Your account: name, email, roles and memberships and Your creator profile, stats, brands, videos, bounties and games. Add Your earnings, payouts and payout-account status if you want the agent to see money. Copy the token: it's shown only once.

Full steps: API tokens.

Connect your agent

In the window that shows your new token, pick your app under Connect an AI agent (MCP): Claude Code, Cursor, VS Code, Claude Desktop or another. The setup already includes your token, so you copy one command or click Add to Cursor or Add to VS Code. Full steps: AI agents (MCP).

Ask away

Ask your agent a question about your Bloss data, like the ones above.

Prefer code?

The same data is available from the Bloss API, so you can pull it into a spreadsheet, a dashboard or your own scripts. See Platform API.

Stay in control

  • The agent can't change anything. It can't post, edit, claim a bounty or move money. Do those in the Bloss app.
  • It sees only what you allow. It reads only the permissions you ticked, and only your own data. Use Only these brands on the token to keep it to some of your brands.
  • Payout details stay masked. Even with money permissions, it never sees full payment details.
  • Turn it off any time. Revoke the token in AccountAPI tokens and the agent loses access right away.

Was this page helpful?

Last reviewed Oct 23, 2026

Was this page helpful?

Use this page with AI

View as MarkdownAsk ChatGPTAsk Claude

On this page