THE TAKEAWAY

MCP lets an agent client discover and call tools exposed by a server. Its technical catalog still needs an objective and action boundaries.

01STORY BRIEFThe idea in three screens.3 SCREENS
THE SIGNAL

MCP connects tools. It does not write your strategy.

MCP lets an agent client discover and call tools exposed by a server.

1 / 3 · YOUR OWN PACE

Read descriptions and annotations before composing a recipe. A read operation differs from paid creation. TokPortal’s documentation distinguishes local and remote servers. Choose transport for your environment and test the contract in preview before commercial execution.

A readable recipe names the intent before listing calls: prepare an account in a market, verify its state, organize publication. Each step should state what it requires from the previous one. Readers can then understand dependencies and see why synthetic preview identifiers must never pass into live operations. Tool availability is only one part of building a coherent, authorized workflow.

A tool catalogue is not an operating plan

MCP makes tools discoverable to an assistant, but discoverability does not decide when a tool should be used. The orchestrator still needs to understand the account, the intended action, the input contract and the side effects. Read tool descriptions and current documentation before constructing a workflow. A list operation, a preview and a purchase may sit beside each other in the same catalogue while requiring different authority. Preserve that distinction in the plan and in the interface shown to the person approving consequential work.

THE IDEA, UNPACKED

From discoverable tools to a reviewable action

  1. 01
    Discover

    Read the current tool contract and side effects.

  2. 02
    Prepare

    Resolve inputs and inspect any supported preview.

  3. 03
    Reconcile

    Store identifiers and verify the returned state.

Editorial model: a way to reason about the process, not measured platform results.

Build the sequence around evidence returned by each step. Resolve identifiers before preparing an action, preview where supported, inspect cost and scope, then execute only the authorised operation. Store the resulting identifiers so later status checks refer to the same task. Do not infer success from a fluent assistant message or from the absence of a thrown error. A useful MCP integration makes the underlying operation easier to inspect. It should not hide uncertainty behind a conversational layer that sounds more complete than the tool response actually is.

INSIDE TOKPORTAL

From the idea to the actual workflow.

Product screens, documented tools and a practical way to connect them.

WORKBENCH / CONNECTDOCUMENTED · 2026-09-09

Connect an AI assistant to the actual TokPortal tools

The remote MCP address is the entry point for an assistant. The screenshot shows TokPortal’s real connection screen, including the authorisation step. Your API key does not belong in an editorial prompt.

TokPortal connection screen with the remote MCP URL and Claude connection steps.
Actual TokPortal MCP connection screen, captured 8 September 2026. Product ↗
MCP CONNECTIONhttps://app.tokportal.com/api/ext/mcp
AI PLANNING BRIEF
AI PLANNING BRIEF
Inspect my existing TikTok accounts and the current credit rules.
Prepare three distinct creative angles for a US audience.
For each, identify the account, required media and a valid publishing window.
Preview any proposed creation with dry_run: true.
Report credits_would_charge, recurring Coverage and missing inputs.
Do not create or publish a live task.

Copy this as a planning brief after connecting your assistant. It asks for a concrete preview, not a pretend transcript of successful execution. Remote MCP supports the documented dry-run workflow; local tokportal-mcp needs version 1.15.1 or later.

  1. 01
    Read-only first

    Choose read-only access when the job is inventory or analysis. Publishing requires an appropriately authorised connection.

  2. 02
    Discover current tools

    Use the tool catalogue available in the connected workspace instead of assuming a capability from a marketing page.

  3. 03
    Review before execution

    Check destination, assets, price and review windows against the actual tool response.

READ THE CONTRACT mcp
WORKBENCH / PREVIEWDOCUMENTED · 2026-09-09

Preview an account with three video slots before committing credits

The archived builder shows account and video-package choices. This sample MCP request previews a package with one account and three video slots; it does not upload three video files.

TokPortal bundle builder showing platform and account-plus-video choices.
Actual TokPortal builder, captured 8 September 2026. Product ↗
REST EQUIVALENTPOST /api/ext/bundles
ANNOTATED EXAMPLE
MCP · DRY RUN
{
  "tool": "tokportal_create_bundle",
  "arguments": {
    "dry_run": true,
    "body": {
      "bundle_type": "account_and_videos",
      "platform": "tiktok",
      "country": "USA",
      "videos_quantity": 3,
      "edits_quantity": 0,
      "wants_advanced_warming": false,
      "auto_finalize_videos": false
    }
  }
}

This is a sample request, not an executed order or a price quote. In REST, the equivalent simulation uses X-TokPortal-Dry-Run: true. Live creation debits credits immediately; the preview is the place to inspect the actual workspace-specific price.

  1. 01
    Read the quote

    Read the quoted credit fields and cost_breakdown returned by the current contract. A simulation does not debit the live balance.

  2. 02
    Keep simulation separate

    Returned simulation IDs are synthetic and cannot be reused in live requests. The simulation does not retain cross-call objects.

  3. 03
    Review the package

    auto_finalize_videos is explicitly false here. Check the current review-window rules before any live execution.

READ THE CONTRACT sandbox mcp
MCP connects tools. It does not write your strategy.
02FIELD KITFrom concept to practice.2 SCREENS
PUT IT TO WORK / 1

Discover the current catalog.

Adapt this to your audience, budget and test scope.

1 / 2 · YOUR OWN PACE

Put it to work.

  1. 01Discover the current catalog.
  2. 02Separate read tools from mutations.

Notes & sources.

The limit. A tool name is not enough to understand costs and side effects.

SOURCES & PROVENANCE

THE ORGANIC CLUB is an editorial project initiated by TokPortal. That relationship is separate from the evidence behind claims. Editorial signatures and image credits are explained in our policy. Our editorial policy →