Agents × jobs

Pull analytics across all accounts with any AI agent

Pull TikTok/Instagram analytics across every managed account from any of 25 agents: get_analytics_dashboard, get_analytics_series, list_account_video_an…

From any MCP-capable agent, one call summarizes every managed account: get_analytics_dashboard (filters platform, country, account, from/to), get_analytics_series for daily or weekly curves of views/likes/comments/shares/followers, list_account_video_analytics per account, get_comment_pulse for what people say, and export_analytics_videos / create_analytics_report for the CSV or branded report. TokPortal collects the numbers because it operates the accounts — no per-account OAuth, no Business-account requirement, no scraping on your side.

Try the workflow without spending

For this trial, use the remote MCP endpoint https://app.tokportal.com/api/ext/mcp, local tokportal-mcp 1.15.1 or later, or the REST API. Upgrade and restart an older local server first. Version 1.15.0 does not forward the dry-run header; do not use its write tools for a simulation. If you cannot verify the installed local version, use the remote endpoint or REST.

Use the sandbox for the first attempt. MCP write tools accept dry_run: true as a top-level argument, beside body; REST writes accept the X-TokPortal-Dry-Run: true header. Keep your usual authentication and scopes. Each simulated write validates the request and returns credits_would_charge with credits_charged: 0. Nothing is created or published.

Simulated IDs start with 00000000-0000-4000-8000-. Use them only in later dry-run writes. GET requests read real data, so skip publish-readiness checks and polling for synthetic IDs. Simulations have no cross-call memory and upload URLs are placeholders: do not upload files to them.

To run for real, review the returned price and confirm before the first live write. Bundle creation charges credits immediately; publishing hands the order to a manager. Repeat creation without dry-run mode and use the new real IDs for configuration and publishing. A synthetic ID cannot be reused in a live request.

How it works

Analytics in TokPortal are workspace-wide and account-scoped at once. Start with get_analytics_contract once — it tells the agent which metrics, granularities and freshness guarantees apply to your workspace — then get_analytics_dashboard for the headline numbers over from/to, filtered by repeatable platform, country and account params. get_analytics_series returns time series with metric (views, likes, comments, shares, followers), granularity (day, week) and mode (cumulative, gained, snapshot) — gained per day is what most dashboards want.

Per account, get_analytics_account (or get_account_analytics) gives the profile-level snapshot and list_account_video_analytics the per-video table (paginated, sort_by/sort_order), which the agent can rank to find winning hooks. Comments: get_comment_pulse for the aggregate mood and list_analytics_account_comments for the text. If a number looks stale, can_refresh_account_analytics says whether a refresh is allowed and refresh_account_analytics triggers it — refreshes are rate-limited by design.

For deliverables, export_analytics_videos returns a CSV filtered by account, platform, country, q, from, to; create_analytics_report returns a structured report and export_analytics_report_html a branded HTML page. From any MCP-capable agent the useful pattern is a scheduled digest: every morning, dashboard for yesterday, top 5 videos, accounts with zero posts in 7 days (join with list_accounts), any new entries in list_account_bans — posted to Slack or written to a sheet.

Tool sequence

  1. tokportal_get_analytics_contract — Metrics, granularities and freshness rules for your workspace.
  2. tokportal_get_analytics_dashboard — Totals over from/to with platform/country/account filters.
  3. tokportal_get_analytics_series — metric, granularity, mode, optional account.
  4. tokportal_list_accounts — Enumerate accounts (platform, country, banned=false) to iterate.
  5. tokportal_list_account_video_analytics — Per-video table per account, sortable.
  6. tokportal_get_comment_pulse — Aggregate comment signal across accounts.
  7. tokportal_refresh_account_analytics — Force a refresh when can_refresh_account_analytics allows.
  8. tokportal_export_analytics_videos — CSV for spreadsheets.
  9. tokportal_create_analytics_report — Structured report (or export_analytics_report_html).

Pick your agent