Skip to main content
Glama

AdsAgent — TikTok Ads MCP

List TikTok Business Centers

assets_list_business_centers
Read-only

List cached TikTok Business Centers (Meta wire name: businesses) for the authenticated tenant, across every connection. Each row is augmented with advertiser_count and pixel_count computed from owner_bc_id, so per-BC inventory is visible without extra calls. Mirrors Meta MCP assets_list_businesses.

Returns a compact bounded page. Optional: cursor from the previous response, limit (default 20, maximum 50), and search (case-insensitive native id/name lookup). Keep the same tool, filters and limit while following next_cursor serially until complete=true. A rejected or old cursor requires restarting page one. complete describes pagination, not upstream sync coverage or permission to create.

REQUIRED: none. EXAMPLE: assets_list_business_centers({"limit": 20})

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
limitNo
cursorNo
searchNo
connection_contextNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedInput schema / properties / connection_context
      Added value: +{
      +  "pattern": "^mctx_v1_[0-9a-f]{64}$",
      +  "type": "string"
      +}
  2. First observed

TDQS

A3.8/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint=true, destructiveHint=false, and openWorldHint=false, so the safety profile is covered. The description adds non-obvious context: the data is cached, rows are augmented with computed counts, cursors can be rejected/expire requiring restart, and 'complete' does not imply upstream sync coverage or creation permission. Only freshness/staleness of the cache is left unstated.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded with the purpose before pagination mechanics, and each paragraph has a distinct job (what it lists, return shape, pagination, caveats). It is somewhat dense and longer than strictly necessary, but no sentence is filler.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

No output schema exists, and the description compensates by describing the return shape (compact bounded page, next_cursor, complete flag) and pagination semantics. Zero required parameters is clear, and the only real gap is the undocumented connection_context parameter.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, so the description must carry parameter meaning, and it does: limit (default 20, max 50), cursor (from previous response, can be rejected/old), and search (case-insensitive native id/name lookup). It omits connection_context entirely, which is the one parameter left undocumented in both schema and description.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource ('List cached TikTok Business Centers') plus scope ('for the authenticated tenant, across every connection') and notes the enrichment fields (advertiser_count, pixel_count). Clear and specific, but it differentiates only implicitly from siblings like assets_list_ad_accounts or assets_list_pixels by resource name alone, with no explicit contrast.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Strong operational guidance on pagination protocol (keep same tool/filters/limit, follow next_cursor serially until complete=true, restart page one on a rejected cursor) and a useful clarification that complete refers to pagination rather than sync coverage. However, it never states when to choose this tool over sibling asset-listing tools, so alternative selection is left to inference.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources