Using busypipe with AI assistants
busypipe can connect directly to your AI assistant, so you can ask questions about the accounts, hashtags, and sounds you track — “How is my portfolio doing this week?”, “How does our engagement compare to the last 90 days?”, “What’s trending on this sound?” — without leaving your chat. Answers come back as plain numbers, and on request as busypipe-branded chart images you can drop straight into a report or a deck.
This uses MCP (Model Context Protocol), an open standard that lets AI assistants connect to external tools and data sources.
What it does
- Answers questions about your tracked portfolios, profiles, hashtags, and audio — the same analytics you see in the app.
- Shows a portfolio’s competitor scoreboard, its dominant content themes, and which hashtags are used together with a tracked hashtag.
- Finds items you already track by name, across your portfolios.
- Places engagement rates in context with TikTok-wide engagement benchmarks.
- Returns branded chart images when you ask for a chart — available for profile trends, hashtag trends, sound usage, and engagement benchmarks — ready to paste into a report.
- Finds new profiles, hashtags, and sounds and starts tracking them in a portfolio — see Finding and tracking new entities below.
- Browses trending hashtags and search terms by category, trending sounds by chart, and trending videos by region and time window, and lists the available filters — even for things you don’t track yet.
- Only ever reads aggregated data for analytics — trends, leaderboards, comparisons. It never returns raw post-level dumps.
Plan requirement
This integration is available on the Professional plan and above. See Plans & Billing for how to upgrade.
Workspace members with the Viewer role can’t use the AI assistant connection; Owners, Admins, and Analysts can.
Connecting
- Go to Settings → Integrations in busypipe.
- Copy your server URL.
- In your AI assistant, add a custom connector (sometimes called a “remote MCP server”) and paste in the URL.
- Sign in with your busypipe account when prompted.
Only connect using the server address shown on your Settings → Integrations page, and check that the approval screen names the assistant you are connecting before you accept — that screen is what keeps your account yours.
Once connected, your assistant can work in any workspace you belong to. By default it uses your default workspace; if you belong to several, ask it to use a specific one.
Claude
Open Claude’s settings, find the option to add a custom connector, and paste in the server URL from Settings → Integrations. Sign in with your busypipe account when prompted.
ChatGPT
Open ChatGPT’s settings, find the option to add a custom connector, and paste in the server URL from Settings → Integrations. Sign in with your busypipe account when prompted.
Other MCP-capable assistants work the same way — add a remote MCP server pointed at your busypipe server URL and sign in when prompted.
Daily limit
Requests from your AI assistant count toward your workspace’s daily API limit. The limit is shared across every assistant you’ve connected and resets at midnight UTC. If you hit the limit, your assistant will tell you and you can pick back up after the reset.
| Plan | Requests per day | Live TikTok searches per day |
|---|---|---|
| Professional | 500 | 25 |
| Enterprise | 5,000 | 200 |
There is also a short-term burst limit of about 60 requests per minute per workspace. If your assistant hits it, wait a minute and try again. See Plans & Billing for how to upgrade.
Finding and tracking new entities
Your assistant isn’t limited to what you already track — it can find new profiles, hashtags, or sounds and add them to a portfolio without you leaving the chat. “Find TikTok accounts about home coffee brewing and start tracking the top one” works end to end: it searches busypipe’s database first, and runs a live TikTok search when nothing turns up locally.
- Live TikTok searches have their own daily limit (see the table above). A live search counts against both that limit and the general daily limit. It resets at midnight UTC; once it’s hit, your assistant falls back to database-only results and tells you so.
- Your assistant can add and remove tracking. It can add a profile, hashtag, or sound to a portfolio, create new (empty) portfolios to organize them in, remove an item from a portfolio, and delete a whole portfolio. Removing an item from one portfolio leaves it tracked in any other portfolios it belongs to — an item only stops being collected once it’s no longer in any portfolio. Renaming a portfolio is still a busypipe-app action.
- Your assistant keeps notes with you. Every portfolio’s Notes log is shared: your assistant can read it (
list_portfolio_notes) to pick up prior decisions and context, and, once you agree, append to it (add_portfolio_note) when it concludes something. busypipe asks assistants to check with you before they add a note, track or remove something, or spend an Analyze credit. Its notes are marked via API in the app. It can’t edit or delete notes — only a person can delete one, in the app.
Built-in prompts
busypipe also offers ready-made prompts that assistants supporting MCP prompts can list for you:
- Weekly portfolio brief — a concise weekly summary for one portfolio: who gained or lost, engagement shifts, and dominant content themes. It reads the portfolio’s notes first and offers to save its conclusion as a note.
- Competitor benchmark — ranks the own account in a portfolio against its competitors and places their engagement rates in TikTok-wide context. It reads prior notes first and offers to save the ranking as a note.
- Hashtag deep dive — the trend shape of a tracked hashtag, the hashtags most often used with it, and the content niches they suggest.
How to read the numbers
Numbers returned through your AI assistant come from the same analytics engine as the busypipe app, so they always match what you’d see on screen — but a couple of things are worth keeping in mind when you’re quoting them in a report:
- Region reflects where content was observed, not where its creator is based. A post attributed to a region was seen there — that’s not proof the creator lives there.
- Your assistant only sees what you track. Numbers about a specific account, hashtag, or sound are limited to what’s tracked in your workspace’s portfolios; broader benchmark figures are called out as such when they’re platform-wide rather than specific to your tracked items.
- History depth follows your plan. If you ask for a window longer than your plan supports, you’ll get data clamped to what’s available rather than an error.
Your assistant can also ask busypipe directly how a particular number is computed — every connected assistant has access to a built-in methodology reference covering definitions, coverage, and caveats, so you can always ask “how is this calculated?” and get a grounded answer.