Run US TikTok accounts from abroad with Hermes Agent

Q: Which other countries work the same way?

`list_countries` returns the live list (UK, France, Germany, Spain, Brazil, Mexico, UAE and more open regularly). The mechanism — local manager, local device — is identical.

From Hermes Agent, a US TikTok presence is one field away: create_bundle with country: "US" routes the order to a manager physically in the United States, who creates the account on a US device and network, warms it and posts every video you configure. You never touch a VPN, a US phone number or the account itself — you send configure_bundle_video calls from wherever you are and read results with list_accounts and analytics tools. This is the practical answer to "how do I post to US TikTok from Europe/Asia/LATAM" that the official API cannot give, because it only posts on accounts a user already owns and controls.

Connect TokPortal to Hermes Agent

Hermes Agent is an autonomous agent: Nous Research's open-source agent runtime; MCP servers are declared under mcp_servers in ~/.hermes/config.yaml.

~/.hermes/config.yaml:

mcp_servers:
  tokportal:
    url: "https://app.tokportal.com/api/ext/mcp"
    headers:
      Authorization: "Bearer sk_..."

Or the local stdio form:

mcp_servers:
  tokportal:
    command: "npx"
    args: ["-y", "tokportal-mcp"]
    env:
      TOKPORTAL_API_KEY: "sk_..."

Reload with /reload-mcp. Use tools.include to expose only the read-only tokportal_get_* / tokportal_list_* tools to an unattended agent.

Snippet status: verified against Hermes Agent's documentation (source).

Once connected, sanity-check the setup with a read-only call — "What is my TokPortal credit balance?" should trigger tokportal_get_credit_balance. Every tool runs as your TokPortal account and spends your credits; read-only tools (get_*, list_*, export_*) never do.

How it works

Region on TikTok is decided at account creation and reinforced by where the app is used afterwards; an account created abroad and driven through a VPN is the classic recipe for reduced reach and shadow restrictions. TokPortal removes the problem at the source. The country you pass is not a targeting flag on the post — it selects the human manager, their SIM, their residential IP and their device. The account is US-native for its whole life because the person operating it is in the US.

The flow from Hermes Agent is the standard bundle flow: list_countries to confirm US is open, create_bundle (platform: tiktok, country: US, videos_quantity), configure_bundle_account with a handle and bio written for a US audience, then videos with configure_bundle_video or batch_configure_bundle_videos, publish_bundle, and later list_accounts filtered on country=US. Add Advanced Warming terms in US English (generate_warming_terms writes them from a niche description) so the manager's warming sessions teach the algorithm the account is a US viewer of that niche before you post.

Two things are worth telling the agent explicitly. First, TokPortal does not promise reach — it promises a real US account operated by a US manager; the content still has to be good. Second, if the client wants to eventually own the account, reveal_account_credentials is possible but breaks the "operated from the US" property the moment the client logs in from abroad; the recommended pattern is to keep the account managed and use videos_only bundles for every new batch of posts.

Run it from Hermes Agent

Hermes Agent runs autonomously, so the prompt below is written as a goal with an explicit stop before the first write tool. Give it the goal, let it read (get_*, list_*), then confirm before it continues to publish_bundle.

Tool sequence

tokportal_list_countries — Confirm US is in the new-account list (and in videos_only_countries for reuse).
tokportal_get_credit_costs — Quote setup + slots + warming before creating.
tokportal_create_bundle — platform: tiktok, country: US, bundle_type: account_and_videos, videos_quantity, optional wants_advanced_warming.
tokportal_generate_warming_terms — Turn a niche description into US-English search terms (count multiple of 3).
tokportal_configure_bundle_account — US-flavoured username, visible_name, biography, link_in_bio.
tokportal_configure_bundle_video — One call per slot: description, target_publish_date, video_url (max 3/day).
tokportal_publish_bundle — Order goes to a US manager.
tokportal_list_accounts — platform=tiktok&country=US to retrieve profile_url and status.
tokportal_get_account_analytics — Views, followers and per-video numbers of the delivered US account.

Prompt to paste

Use the TokPortal MCP tools. I am based outside the US and want a US TikTok account for a home-fitness brand.
Check list_countries for US, generate 6 US-English warming terms with generate_warming_terms
(platform tiktok, text: "home workouts for busy parents"), then create the bundle
(account_and_videos, country US, 15 videos, advanced warming with those terms),
configure @liftwithmara and stop before publish_bundle with the total from get_credit_costs.

Send the prompt to Hermes; MCP tools are namespaced by server, so look for tokportal_* in the tool list after /reload-mcp.

REST equivalent (same operations, X-API-Key header, base URL https://app.tokportal.com/api/ext)

curl -X POST https://app.tokportal.com/api/ext/bundles \
  -H "X-API-Key: sk_..." -H "Content-Type: application/json" -H "Idempotency-Key: $(uuidgen)" \
  -d '{"bundle_type":"account_and_videos","platform":"tiktok","country":"US","videos_quantity":15,
       "wants_advanced_warming":true,
       "advanced_warming_terms":["home workout no equipment","protein snacks","gym tok"]}'

curl -X PUT https://app.tokportal.com/api/ext/bundles/BUNDLE_ID/account \
  -H "X-API-Key: sk_..." -H "Content-Type: application/json" \
  -d '{"username":"liftwithmara","visible_name":"Mara | Home Gym","biography":"30-min workouts, zero excuses"}'

curl -X PUT https://app.tokportal.com/api/ext/bundles/BUNDLE_ID/videos/1 \
  -H "X-API-Key: sk_..." -H "Content-Type: application/json" \
  -d '{"video_type":"video","description":"Day 1: the only 3 moves you need #homeworkout","target_publish_date":"2026-09-02","video_url":"https://.../day1.mp4"}'

curl -X POST https://app.tokportal.com/api/ext/bundles/BUNDLE_ID/publish -H "X-API-Key: sk_..."

Key parameters

Parameter	Values	Notes
`country`	US	Selects a US-based manager, device and network; not a post-level flag.
`platform`	tiktok	Same flow works for instagram.
`videos_quantity`	0–500	3 per day max per bundle; 15 videos ≈ 5 posting days.
`advanced_warming_terms`	3–30 US-English terms	5 credits each; recorded and verified per term.
`biography`	≤80 chars	Write for a US reader; managers do not rewrite copy.
`link_in_bio`	URI	Optional; use a US-reachable landing page.

Full schemas: OpenAPI reference · openapi.json.

Example configurations

US account, 15 posts, warmed

{"bundle_type":"account_and_videos","platform":"tiktok","country":"US","videos_quantity":15,
 "wants_advanced_warming":true,"advanced_warming_terms_count":6}

More posts on the delivered US account

{"bundle_type":"videos_only","account_id":"ACCOUNT_UUID","videos_quantity":30,"title":"October US drop"}

Bulk US fleet for an agency

{"platforms":["tiktok"],"country":"US","accounts_count":20,"videos_per_account":10,"wants_advanced_warming":true,"advanced_warming_terms_count":3}

Credits

A warmed US account with 15 posts is 32 (setup) + 15 × 2 (slots) + 3 × 5 (warming targets) = 77 credits at standard rates; nothing is charged before publish_bundle. Verify with get_credit_costs — see Credits & Pricing.

Why not the official API

The official Content Posting API cannot make an account American: it posts to whatever account the user authorized, from wherever that account lives, and only after your app is audited (unaudited apps post privately) and the user grants video.publish per account. Geo is a property of the account and its operator, which is what TokPortal's country field controls by putting a US human behind the account.

As of August 2026 the first-party routes look like this. TikTok's Content Posting API (Direct Post) requires each account owner to authorize your app with the video.publish scope, limits every user access token to 6 requests per minute, keeps all posts from unaudited apps in private viewing mode until TikTok audits the app, and enforces an unpublished daily post cap per user (spam_risk_too_many_posts) that integrators commonly report at roughly 15–25 posts per account per day. Meta's Instagram Content Publishing API allows 100 API-published posts per professional account in a 24-hour moving window and only for accounts you own and connect via OAuth. Neither creates accounts, warms them, or reports third-party bans. TokPortal is human-operated infrastructure: accounts created and run by managers in the target country, one X-API-Key for all of them, dated slots (max 3 per day per bundle) instead of per-account tokens.

Sources: TikTok Content Posting API – Direct Post, TikTok Content Posting API – Get started, Instagram Platform – Content Publishing.

Run US TikTok accounts from abroad with Hermes Agent

Connect TokPortal to Hermes Agent

How it works

Run it from Hermes Agent

Key parameters

Example configurations

Credits

Why not the official API

FAQ

Do I need a VPN or a US phone number?

Will the account be shadow-banned because I am abroad?

Can I log in from my country later?

Which other countries work the same way?

Also works with

Other jobs with Hermes Agent