Account API
Use the account actions to learn about the channel before you change anything. get_account_overview is the first call for every script and agent.
Each action is a REST endpoint under https://kickbot.com/api/v1 and an MCP tool with the same name. The MCP area name is account. Use it to load only this area: https://kickbot.com/api/v1/mcp?areas=account.
Every team member with API access can use this area. It needs no feature permission. Owners and admins have every permission. Write actions also need a read and write key or connection. See Permissions and security.
How the feature works in the dashboard: Add KickBot as a moderator, Account settings.
Actions
Section titled “Actions”| Tool | REST | Access |
|---|---|---|
get_account_overview | GET /account | Read |
get_channel_activity | GET /account/activity | Read |
refresh_kick_data | POST /account/refresh-kick-data | Write |
check_moderator_status | POST /account/check-moderator | Write |
get_account_overview
Section titled “get_account_overview”Get the account overview. Start here. Returns the channel, its plan (free or premium) and plan limits, your team role and permissions, what this credential may do, and which areas of KickBot you can use. Call it before making changes.
GET /api/v1/accountNo input fields.
get_channel_activity
Section titled “get_channel_activity”Get the channel activity of the last 30 days. The dashboard Home page: KickBot interactions per day and per feature in the last 30 days (tts, clips, commands, timed_message, chat_alert, ai_character, ai_images, tips, moderated), the busiest day, highlights (top clip, top TTS voice, top command), which features are on, counts at a glance, when the TTS widget was last open in OBS, and the public links (tip page, clips page, voice list). Tip money (tips_amount_30d_cents, biggest_tip_cents, in US cents) is shown only with the tipping configuration permission; otherwise it is null.
GET /api/v1/account/activity| Field | Type | Required | Description |
|---|---|---|---|
time_zone (query) | string | No | IANA time zone for the day boundaries, for example “Europe/Berlin”. Default UTC. An unknown zone uses UTC. |
refresh_kick_data
Section titled “refresh_kick_data”Refresh the Kick channel data. Load the channel name, profile picture, follower count, and stream link from Kick again (the same as “Refresh Kick data” in Settings). Use it after the streamer changed something on Kick. partial: true means Kick gave the name and picture but not the follower count and stream link this time.
POST /api/v1/account/refresh-kick-dataNeeds a read and write key or connection. This has an effect outside your settings (for example on your live stream). Rate limit: 20 per minute.
No input fields.
check_moderator_status
Section titled “check_moderator_status”Check if KickBot is a moderator. Check on Kick now whether KickBot is a moderator in the channel, and save the answer (the same as the “Check again” button in the dashboard warning). Many chat features need KickBot as a moderator: the streamer types /mod KickBot in their Kick chat, then you call this.
POST /api/v1/account/check-moderatorNeeds a read and write key or connection. This has an effect outside your settings (for example on your live stream). Rate limit: 20 per minute.
No input fields.