Servers Playground How we check Add a server Log in

Palmyr

Working · 2.5 s

ai.palmyr/palmyrv1.0.0 Domain verified

Agent infra: email, phone, social, domains, VPS, wallets. Paid per-action via x402, no API key.

AI & Agents Cloud & DevOps

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://palmyr.ai/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

card_buy

Buy a USA prepaid Visa card loaded with EXACTLY the requested balance ($5–$1000). Dynamic x402 price = amount + fee (3% min 0.50 USDC) — the 402 instructions carry the exact total. Returns 202 with an operation_id: poll card_status until ready (~10s), then fetch the number with card_get. US merchants only; non-reloadable (spend across transactions until depleted); max 6 cards per agent per rolling 24h (issuer limit).

amountnumber, required

USD balance to load on the card (min $5, max $1000, whole cents)

paymentstring

base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Palmyr MCP server | mcptry

Tools (33)

card_buy

Argument	Type	Description
amount*	number	USD balance to load on the card (min $5, max $1000, whole cents)
payment	string	base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "amount"
  ],
  "properties": {
    "amount": {
      "type": "number",
      "description": "USD balance to load on the card (min $5, max $1000, whole cents)"
    },
    "payment": {
      "type": "string",
      "description": "base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions"
    }
  },
  "additionalProperties": false
}

card_get

Retrieve a prepaid card you own: full card number, CVV, expiry, live balance. Owner-verified (0.01 USDC ownership proof; the paying wallet must be the card's buyer).

Argument	Type	Description
card_id*	string	card_id returned by card_buy
payment	string	base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "card_id"
  ],
  "properties": {
    "card_id": {
      "type": "string",
      "description": "card_id returned by card_buy"
    },
    "payment": {
      "type": "string",
      "description": "base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions"
    }
  },
  "additionalProperties": false
}

card_list

List cards owned by the paying wallet: status, last4, balance (never full numbers — those are per-card via card_get). 0.01 USDC ownership proof.

Argument	Type	Description
payment	string	base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "payment": {
      "type": "string",
      "description": "base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions"
    }
  },
  "additionalProperties": false
}

card_status

Poll a card purchase started by card_buy (free). done=true when status is 'ready' (fetch details with card_get) or 'failed' (payment auto-refunded — see refund_status).

Argument	Type	Description
card_id*	string	operation_id / card_id returned by card_buy

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "card_id"
  ],
  "properties": {
    "card_id": {
      "type": "string",
      "description": "operation_id / card_id returned by card_buy"
    }
  },
  "additionalProperties": false
}

compute_deploy

Deploy a cloud VPS keyed to your wallet (optionally auto-installs OpenClaw/skills). Priced per server type — the exact quote is returned in the 402 challenge, paid per-action via x402.

Argument	Type	Description
name*	string	Server name
image	string	OS image (default 'ubuntu-24.04')
install	any	Recipe name(s) to install, e.g. 'openclaw'
payment	string	base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions
location	string
serverType*	string	Hetzner server type, e.g. 'cx22'
sshPublicKey	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "name",
    "serverType"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Server name"
    },
    "image": {
      "type": "string",
      "description": "OS image (default 'ubuntu-24.04')"
    },
    "install": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      ],
      "description": "Recipe name(s) to install, e.g. 'openclaw'"
    },
    "payment": {
      "type": "string",
      "description": "base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions"
    },
    "location": {
      "type": "string"
    },
    "serverType": {
      "type": "string",
      "description": "Hetzner server type, e.g. 'cx22'"
    },
    "sshPublicKey": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

domain_check

Check domain availability and per-TLD pricing. Pass a full domain (example.com) or a bare name to scan popular TLDs. Free — no payment required.

Argument	Type	Description
domain*	string	A full domain (example.com) or a bare name (example)

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "domain"
  ],
  "properties": {
    "domain": {
      "type": "string",
      "description": "A full domain (example.com) or a bare name (example)"
    }
  },
  "additionalProperties": false
}

domain_register

Register a domain to your wallet. Priced per TLD — the exact quote is returned in the 402 challenge, paid per-action via x402.

Argument	Type	Description
domain*	string	Full domain to register, e.g. 'example.com'
payment	string	base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "domain"
  ],
  "properties": {
    "domain": {
      "type": "string",
      "description": "Full domain to register, e.g. 'example.com'"
    },
    "payment": {
      "type": "string",
      "description": "base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions"
    }
  },
  "additionalProperties": false
}

email_create_inbox

Provision an email inbox at {name}@palmyr.ai (or a custom domain you own), keyed to your wallet. Costs 2.00 USDC, paid per-action via x402.

Argument	Type	Description
name*	string	Local part of the address; inbox becomes {name}@palmyr.ai
domain	string	A Namecheap-registered domain you own; auto-sets MX/SPF/DKIM
payment	string	base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions
walletAddress	string	Solana pubkey to enable E2E encryption (defaults to the payer)
solanaPublicKey	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Local part of the address; inbox becomes {name}@palmyr.ai"
    },
    "domain": {
      "type": "string",
      "description": "A Namecheap-registered domain you own; auto-sets MX/SPF/DKIM"
    },
    "payment": {
      "type": "string",
      "description": "base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions"
    },
    "walletAddress": {
      "type": "string",
      "description": "Solana pubkey to enable E2E encryption (defaults to the payer)"
    },
    "solanaPublicKey": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

email_create_temp

Provision a cheap, disposable, receive-only email inbox — ideal for receiving a one-off verification or order-confirmation email during a checkout/signup flow. The address (a natural-looking handle on a dedicated inbox domain) is returned in the response. Auto-expires (default 24h). Reads return plaintext to the owning wallet (no E2E key to manage). Costs 0.50 USDC, paid per-action via x402.

Argument	Type	Description
payment	string	base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions
ttl_seconds	number	Lifetime in seconds before the inbox auto-expires (default 86400 = 24h, min 300, max 604800)

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "payment": {
      "type": "string",
      "description": "base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions"
    },
    "ttl_seconds": {
      "type": "number",
      "description": "Lifetime in seconds before the inbox auto-expires (default 86400 = 24h, min 300, max 604800)"
    }
  },
  "additionalProperties": false
}

email_extend_temp

Rent another 7 days on a live disposable temp inbox — each call pushes expires_at exactly 7 days further (fixed, stackable, no cap). Owner-only; expired temp inboxes cannot be revived (buy a new one via email_create_temp). Costs 0.50 USDC, paid per-action via x402.

Argument	Type	Description
payment	string	base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions
inbox_id*	string	Temp inbox id returned by email_create_temp

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "inbox_id"
  ],
  "properties": {
    "payment": {
      "type": "string",
      "description": "base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions"
    },
    "inbox_id": {
      "type": "string",
      "description": "Temp inbox id returned by email_create_temp"
    }
  },
  "additionalProperties": false
}

email_read_messages

Read decrypted messages from an inbox you own (payment wallet must match the inbox). Costs 0.02 USDC, paid per-action via x402.

Argument	Type	Description
limit	number	Page size (default 50, max 200)
cursor	string	id of the last message from the previous page
payment	string	base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions
inbox_id*	string	Inbox id returned by email_create_inbox

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "inbox_id"
  ],
  "properties": {
    "limit": {
      "type": "number",
      "description": "Page size (default 50, max 200)"
    },
    "cursor": {
      "type": "string",
      "description": "id of the last message from the previous page"
    },
    "payment": {
      "type": "string",
      "description": "base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions"
    },
    "inbox_id": {
      "type": "string",
      "description": "Inbox id returned by email_create_inbox"
    }
  },
  "additionalProperties": false
}

email_send

Send an email from an inbox you own. Costs 0.08 USDC, paid per-action via x402.

Argument	Type	Description
to*	string	Recipient email address
body*	string
html	string
payment	string	base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions
subject*	string
inbox_id*	string	Inbox id returned by email_create_inbox

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "inbox_id",
    "to",
    "subject",
    "body"
  ],
  "properties": {
    "to": {
      "type": "string",
      "description": "Recipient email address"
    },
    "body": {
      "type": "string"
    },
    "html": {
      "type": "string"
    },
    "payment": {
      "type": "string",
      "description": "base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions"
    },
    "subject": {
      "type": "string"
    },
    "inbox_id": {
      "type": "string",
      "description": "Inbox id returned by email_create_inbox"
    }
  },
  "additionalProperties": false
}

i402_plan

State an intent, get a priced execution plan. The i402 orchestrator turns a natural-language outcome into an ordered list of x402 calls your agent signs and runs. Costs 0.10 USDC per plan, paid per-action via x402.

Argument	Type	Description
intent*	string	Natural-language outcome, e.g. 'register a .com and set up email on it'
params	object	Optional structured parameters for the intent
payment	string	base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions
quality	string	Optional quality hint, e.g. 'fast' \| 'best'
budget_usdc*	number	Max total USDC to spend across the whole plan
constraints	object
deadline_seconds	number
allow_budget_exceeded	boolean	Return an executable plan even if it exceeds budget_usdc

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "intent",
    "budget_usdc"
  ],
  "properties": {
    "intent": {
      "type": "string",
      "description": "Natural-language outcome, e.g. 'register a .com and set up email on it'"
    },
    "params": {
      "type": "object",
      "description": "Optional structured parameters for the intent",
      "additionalProperties": {}
    },
    "payment": {
      "type": "string",
      "description": "base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions"
    },
    "quality": {
      "type": "string",
      "description": "Optional quality hint, e.g. 'fast' | 'best'"
    },
    "budget_usdc": {
      "type": "number",
      "description": "Max total USDC to spend across the whole plan"
    },
    "constraints": {
      "type": "object",
      "additionalProperties": {}
    },
    "deadline_seconds": {
      "type": "number"
    },
    "allow_budget_exceeded": {
      "type": "boolean",
      "description": "Return an executable plan even if it exceeds budget_usdc"
    }
  },
  "additionalProperties": false
}

palmyr_capabilities

List the i402 capabilities Palmyr can plan and execute (the intent-resolver catalog). Free — no payment required.

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

palmyr_pricing

List every paid Palmyr capability and its live x402 price (USDC on Solana/Base). Free — no payment required.

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

phone_buy_number

Provision a real phone number (SMS + voice) for your agent. Costs 3.00 USDC, paid per-action via x402.

Argument	Type	Description
country*	string	ISO-2 country code, e.g. 'US'
payment	string	base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions
areaCode	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "country"
  ],
  "properties": {
    "country": {
      "type": "string",
      "description": "ISO-2 country code, e.g. 'US'"
    },
    "payment": {
      "type": "string",
      "description": "base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions"
    },
    "areaCode": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

phone_extend_temp

Rent another 30 minutes on a live disposable temp number — each call pushes expires_at 30 min further (stackable up to 24h total lease). Owner-only; expired temp leases cannot be revived (lease a fresh one via phone_temp_number). Costs 0.20 USDC, paid per-action via x402.

Argument	Type	Description
payment	string	base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions
number_id*	string	Temp number lease id returned by phone_temp_number

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "number_id"
  ],
  "properties": {
    "payment": {
      "type": "string",
      "description": "base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions"
    },
    "number_id": {
      "type": "string",
      "description": "Temp number lease id returned by phone_temp_number"
    }
  },
  "additionalProperties": false
}

phone_read_messages

Read SMS messages received on a phone number you own. Costs 0.02 USDC, paid per-action via x402.

Argument	Type	Description
payment	string	base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions
number_id*	string	Phone number id returned by phone_buy_number

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "number_id"
  ],
  "properties": {
    "payment": {
      "type": "string",
      "description": "base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions"
    },
    "number_id": {
      "type": "string",
      "description": "Phone number id returned by phone_buy_number"
    }
  },
  "additionalProperties": false
}

phone_send_sms

Send an SMS from a phone number you own. Costs 0.05 USDC, paid per-action via x402.

Argument	Type	Description
to*	string	Recipient number in E.164, e.g. '+15551234567'
body*	string
payment	string	base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions
number_id*	string	Phone number id returned by phone_buy_number

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "number_id",
    "to",
    "body"
  ],
  "properties": {
    "to": {
      "type": "string",
      "description": "Recipient number in E.164, e.g. '+15551234567'"
    },
    "body": {
      "type": "string"
    },
    "payment": {
      "type": "string",
      "description": "base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions"
    },
    "number_id": {
      "type": "string",
      "description": "Phone number id returned by phone_buy_number"
    }
  },
  "additionalProperties": false
}

phone_temp_number

Lease a cheap, instant, receive-only US phone number from a pool to receive one SMS verification code — the phone analogue of a disposable temp email inbox. $0.20 for 30 min (ttl_seconds, clamped 300–1800), returned to the pool at expiry; call wait_for_otp to catch the code. Good for one-time SMS verification and phone-gated signups. Works with major sites like Google, X, and Discord; some (Telegram, WhatsApp, OpenAI) may reject it as a VoIP number — for strict sites, buy a dedicated number with phone_buy_number. Pool numbers are recycled after the lease, so use them for one-time codes only, not long-term 2FA. Costs 0.20 USDC, paid per-action via x402.

Argument	Type	Description
payment	string	base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions
ttl_seconds	number	Lease lifetime in seconds before auto-expiry (default 1800 = 30min, min 300, max 1800)

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "payment": {
      "type": "string",
      "description": "base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions"
    },
    "ttl_seconds": {
      "type": "number",
      "description": "Lease lifetime in seconds before auto-expiry (default 1800 = 30min, min 300, max 1800)"
    }
  },
  "additionalProperties": false
}

tiktok_accounts

List the TikTok accounts the paying wallet owns, with session health (status, profile_present, hours_since_success, last_error_code) — i.e. which of your accounts are still logged in. Costs 0.001 USDC, paid per-action via x402.

Argument	Type	Description
tag	string	Only accounts carrying this tag
payment	string	base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "tag": {
      "type": "string",
      "description": "Only accounts carrying this tag"
    },
    "payment": {
      "type": "string",
      "description": "base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions"
    }
  },
  "additionalProperties": false
}

tiktok_analytics

Scrape per-post analytics (views, likes, comments, shares) for a TikTok account you control, and record a sample so tiktok_series can answer 'is it still growing'. Async: returns an operation to poll with tiktok_operation_status. Costs 0.005 USDC, paid per-action via x402.

Argument	Type	Description
cookies	array	Session cookies for the TikTok account. Omit for an account connected with tiktok_connect — its session lives in that account's own browser profile on the server, so there is no jar to send.
country	string
payment	string	base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions
account_id*	string	Your identifier for the TikTok account
proxy_session_id	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "account_id"
  ],
  "properties": {
    "cookies": {
      "type": "array",
      "description": "Session cookies for the TikTok account. Omit for an account connected with tiktok_connect — its session lives in that account's own browser profile on the server, so there is no jar to send."
    },
    "country": {
      "type": "string"
    },
    "payment": {
      "type": "string",
      "description": "base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions"
    },
    "account_id": {
      "type": "string",
      "description": "Your identifier for the TikTok account"
    },
    "proxy_session_id": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

tiktok_cancel_scheduled

Cancel a post queued with tiktok_post(schedule_at). TikTok has no 'unschedule', so this deletes the held video — the cancellation is recorded only once that succeeded. Async: returns an operation to poll with tiktok_operation_status. Costs 0.001 USDC, paid per-action via x402.

Argument	Type	Description
cookies	array	Session cookies for the TikTok account. Omit for an account connected with tiktok_connect — its session lives in that account's own browser profile on the server, so there is no jar to send.
country	string
payment	string	base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions
account_id*	string	Your identifier for the TikTok account holding the post
operation_id*	string	operation_id of the scheduled post (as returned by tiktok_post / listed by tiktok_scheduled)
proxy_session_id	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "operation_id",
    "account_id"
  ],
  "properties": {
    "cookies": {
      "type": "array",
      "description": "Session cookies for the TikTok account. Omit for an account connected with tiktok_connect — its session lives in that account's own browser profile on the server, so there is no jar to send."
    },
    "country": {
      "type": "string"
    },
    "payment": {
      "type": "string",
      "description": "base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions"
    },
    "account_id": {
      "type": "string",
      "description": "Your identifier for the TikTok account holding the post"
    },
    "operation_id": {
      "type": "string",
      "description": "operation_id of the scheduled post (as returned by tiktok_post / listed by tiktok_scheduled)"
    },
    "proxy_session_id": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

tiktok_connect

Attach a TikTok account by logging in ON THE SERVER, into that account's own persistent browser profile: returns a connect_url to hand a human, who scans the QR in the TikTok app. The recommended path — the browser that authenticates is the browser that later acts, and every other TikTok tool then works with `cookies` omitted (no jar to move). The paying wallet becomes the account's owner. Async: poll tiktok_connect_status with the returned token. Costs 0.01 USDC, paid per-action via x402.

Argument	Type	Description
tag	string	Label grouping accounts (a niche, a client); tiktok_accounts and tiktok_hooks can scope to it
country	string	ISO-2 country the login browser should exit from, e.g. 'US' — TikTok reads a scan from the wrong country as phishing
payment	string	base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions
account_id*	string	Your identifier for the TikTok account (1-64 chars of A-Z a-z 0-9 . _ -)
proxy_session_id	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "account_id"
  ],
  "properties": {
    "tag": {
      "type": "string",
      "description": "Label grouping accounts (a niche, a client); tiktok_accounts and tiktok_hooks can scope to it"
    },
    "country": {
      "type": "string",
      "description": "ISO-2 country the login browser should exit from, e.g. 'US' — TikTok reads a scan from the wrong country as phishing"
    },
    "payment": {
      "type": "string",
      "description": "base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions"
    },
    "account_id": {
      "type": "string",
      "description": "Your identifier for the TikTok account (1-64 chars of A-Z a-z 0-9 . _ -)"
    },
    "proxy_session_id": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

tiktok_connect_status

Poll a server-side login started by tiktok_connect (free). done=true when state is 'completed' (the account is live and usable with cookies omitted) or 'failed'.

Argument	Type	Description
token*	string	Connect token returned by tiktok_connect

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "token"
  ],
  "properties": {
    "token": {
      "type": "string",
      "description": "Connect token returned by tiktok_connect"
    }
  },
  "additionalProperties": false
}

tiktok_hooks

Which caption openings actually earn views. Pass account_id or tag to measure YOUR accounts against their own median (0.001 USDC). Pass niche to report what is working in that niche across TikTok, needing no posting history — the answer for a brand-new account (0.05 USDC; tiktok_niches lists them, free). The two are never blended. Pass caption to classify a draft before posting. Paid per-action via x402 — the 402 challenge carries the exact price for the arguments you sent.

Argument	Type	Description
tag	string	Pool every account you own carrying this tag (0.001 USDC)
niche	string	Report the niche across TikTok — any word, resolved to the nearest known niche (0.05 USDC)
caption	string	Classify this draft caption against the patterns in scope instead of returning the full report
payment	string	base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions
account_id	string	Measure this account you own (0.001 USDC)
recency_days	number	Widen or narrow the recency window (hooks decay; more sample, staler signal)
maturity_days	number	Only count posts at least this old, so young posts don't drag the median

Input schema (JSON)

tiktok_niches

List the niches tiktok_hooks can report on, with how fresh each corpus is. Free — an agent should not pay to learn what it may ask for.

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

tiktok_operation_status

Poll an async TikTok operation started by tiktok_post / tiktok_analytics / tiktok_cancel_scheduled (free). done=true when status is 'posted' / 'done' (carries video_url or the op's result) or 'failed' (payment auto-refunded — see refund_status).

Argument	Type	Description
operation_id*	string	operation_id returned by the tool that started the operation

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "operation_id"
  ],
  "properties": {
    "operation_id": {
      "type": "string",
      "description": "operation_id returned by the tool that started the operation"
    }
  },
  "additionalProperties": false
}

tiktok_post

Post a video to a TikTok account you control (from video_base64 or video_url), immediately or scheduled. Async: returns an operation to poll with tiktok_operation_status. Costs 0.01 USDC, paid per-action via x402.

Argument	Type	Description
caption*	string
cookies	array	Session cookies for the TikTok account. Omit for an account connected with tiktok_connect — its session lives in that account's own browser profile on the server, so there is no jar to send.
country	string
payment	string	base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions
privacy	string
video_url	string	Public URL to the video (preferred; no size limit)
account_id*	string	Your identifier for the TikTok account
schedule_at	string	ISO-8601 datetime to publish at. Uses TikTok's OWN scheduler, which accepts only ~15 minutes to ~10 days ahead — a time outside that window is rejected and refunded, and there is no way to schedule further out. Omit to post immediately. A scheduled post returns its video_id/video_url plus scheduled_at and pending_publish:true — the video exists immediately but its URL is NOT publicly reachable until it publishes.

tiktok_scheduled

List the posts you have queued with tiktok_post(schedule_at), and whether each is still pending, due, or confirmed published. Palmyr's own record — TikTok exposes no way to read pending posts back, so edits made directly in TikTok Studio are invisible to it. Costs 0.001 USDC, paid per-action via x402.

Argument	Type	Description
payment	string	base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions
account_id	string	Only posts for this account
include_done	boolean	Also return posts already published or cancelled

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "payment": {
      "type": "string",
      "description": "base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions"
    },
    "account_id": {
      "type": "string",
      "description": "Only posts for this account"
    },
    "include_done": {
      "type": "boolean",
      "description": "Also return posts already published or cancelled"
    }
  },
  "additionalProperties": false
}

tiktok_series

Read the stored per-post history for an account you own: the full time series for one video (video_id), per-video growth over a window (hours), or the latest sample per video (neither). Samples come from tiktok_analytics runs, so history exists only for what you have scraped. Costs 0.001 USDC, paid per-action via x402.

Argument	Type	Description
hours	number	Return per-video growth over the last N hours
payment	string	base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions
video_id	string	Return the full sample series for this one video
account_id*	string	Your identifier for the TikTok account

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "account_id"
  ],
  "properties": {
    "hours": {
      "type": "number",
      "description": "Return per-video growth over the last N hours"
    },
    "payment": {
      "type": "string",
      "description": "base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions"
    },
    "video_id": {
      "type": "string",
      "description": "Return the full sample series for this one video"
    },
    "account_id": {
      "type": "string",
      "description": "Your identifier for the TikTok account"
    }
  },
  "additionalProperties": false
}

twitter_post

Post a tweet from an X account you control (via injected session cookies). Costs 0.001 USDC, paid per-action via x402.

Argument	Type	Description
text*	string	Tweet text
cookies*	array	Non-empty array of session cookies for the X account
payment	string	base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions
account_id*	string	Your identifier for the X account
community_id	string
proxy_session_id	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "account_id",
    "cookies",
    "text"
  ],
  "properties": {
    "text": {
      "type": "string",
      "description": "Tweet text"
    },
    "cookies": {
      "type": "array",
      "description": "Non-empty array of session cookies for the X account"
    },
    "payment": {
      "type": "string",
      "description": "base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions"
    },
    "account_id": {
      "type": "string",
      "description": "Your identifier for the X account"
    },
    "community_id": {
      "type": "string"
    },
    "proxy_session_id": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

wait_for_otp

Wait for an SMS verification code / OTP to arrive on a Palmyr phone number you own, and return the parsed code. Blocks up to timeout_s (default 60, max 90) checking every ~2s — one call replaces hand-rolled polling of phone_read_messages during account signups and 2FA flows. Messages that arrived up to lookback_s seconds (default 10) BEFORE the call also match, so a code that landed early is not missed — pass lookback_s=0 when reusing a number across signups so a stale code can't be re-served. Default extraction handles standalone 4-8 digit codes, 'code is/code:' tokens, and Google-style G-XXXXXX; pass pattern to override (max 256 chars; a pattern that blows its per-match budget is dropped mid-wait and pattern_timeout: true is reported). Returns { found: true, code, message_text } on a hit or { found: false, waited_s } on timeout (not an error — just call again). Costs 0.02 USDC, paid per-action via x402.

Argument	Type	Description
pattern	string	Custom extraction regex overriding the default OTP formats (first capture group wins, else the full match; max 256 chars)
payment	string	base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions
number_id*	string	Phone number id returned by phone_buy_number
timeout_s	number	Seconds to block waiting (default 60, max 90)
lookback_s	number	Also match messages received up to this many seconds before the call (default 10; use 0 for reused numbers)

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "tag": {
      "type": "string",
      "description": "Pool every account you own carrying this tag (0.001 USDC)"
    },
    "niche": {
      "type": "string",
      "description": "Report the niche across TikTok — any word, resolved to the nearest known niche (0.05 USDC)"
    },
    "caption": {
      "type": "string",
      "description": "Classify this draft caption against the patterns in scope instead of returning the full report"
    },
    "payment": {
      "type": "string",
      "description": "base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions"
    },
    "account_id": {
      "type": "string",
      "description": "Measure this account you own (0.001 USDC)"
    },
    "recency_days": {
      "type": "number",
      "description": "Widen or narrow the recency window (hooks decay; more sample, staler signal)"
    },
    "maturity_days": {
      "type": "number",
      "description": "Only count posts at least this old, so young posts don't drag the median"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "number_id"
  ],
  "properties": {
    "pattern": {
      "type": "string",
      "description": "Custom extraction regex overriding the default OTP formats (first capture group wins, else the full match; max 256 chars)"
    },
    "payment": {
      "type": "string",
      "description": "base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions"
    },
    "number_id": {
      "type": "string",
      "description": "Phone number id returned by phone_buy_number"
    },
    "timeout_s": {
      "type": "number",
      "description": "Seconds to block waiting (default 60, max 90)"
    },
    "lookback_s": {
      "type": "number",
      "description": "Also match messages received up to this many seconds before the call (default 10; use 0 for reused numbers)"
    }
  },
  "additionalProperties": false
}