TokPortal MCP Server for Cursor

The public MCP package is tokportal-mcp. It lets Cursor call generated TokPortal tools using your API key. This is a local stdio MCP server; your key is passed to the TokPortal API by the local process.

Install

Add this to .cursor/mcp.json:

{
  "mcpServers": {
    "tokportal": {
      "command": "npx",
      "args": ["-y", "tokportal-mcp"],
      "env": {
        "TOKPORTAL_API_KEY": "sk_your_key_here"
      }
    }
  }
}

Get your key from the Developer Portal.

Reference: MCP Server

Verify the connection

Ask Cursor:

"Use the TokPortal MCP tools to show my credit balance."

If connected, Cursor should call tokportal_get_credit_balance.

Create a bundle from Cursor

Use a prompt that forces Cursor to show the payload before executing:

"Prepare a TokPortal request for a US TikTok bundle with 10 video slots and niche warming for SaaS/tech content. Show the exact MCP tool call first. Wait for confirmation before running it."

Expected tool shape:

{
  "tool": "tokportal_create_bundle",
  "args": {
    "bundle_type": "account_and_videos",
    "platform": "tiktok",
    "country": "US",
    "videos_quantity": 10,
    "wants_niche_warming": true,
    "niche_warming_instructions": "SaaS and technology content.",
    "external_ref": "cursor-saas-us"
  }
}

Costs are returned by the API as credits_charged and cost_breakdown; do not hardcode them in your agent logic.

Configure videos from project files

Cursor can read local files if you allow it. A useful workflow is:

"Read marketing/video-plan.md, extract 5 captions and video URLs, then configure positions 1-5 on bundle bnd_.... Use target_publish_date starting 5 days from today. Show the batch payload before executing."

Expected API surface:

tokportal_batch_configure_bundle_videos
PUT /bundles/{id}/videos/batch
body shape: { "videos": [...] }

Reference: Configure Videos

Monitor status and analytics

Useful tools:

Tool	Use
`tokportal_get_bundle`	Inspect bundle status and configured fields
`tokportal_get_bundle_publish_readiness`	See why a bundle cannot publish yet
`tokportal_list_accounts`	List delivered accounts
`tokportal_get_account_analytics`	Fetch account analytics when available
`tokportal_list_account_video_analytics`	Fetch post-level analytics

Analytics availability depends on the account/post state and your plan. See Analytics.

Operational guardrails

Ask Cursor to confirm mutating calls before execution.
Use external_ref to connect TokPortal records to your internal campaign IDs.
Do not ask the agent to promise views, engagement, reach, or platform enforcement outcomes.
Use Webhooks for production monitoring instead of relying only on chat output.