Palmyr

Add to your AI

Remote MCP server (streamable HTTP). Most clients sign you in with the provider on first use.

Claude Code

claude mcp add --transport http palmyr https://palmyr.ai/mcp

Claude Desktop, Cursor, Windsurf (mcp config)

{
  "mcpServers": {
    "palmyr": {
      "url": "https://palmyr.ai/mcp"
    }
  }
}

ChatGPT: Settings → Connectors → add a custom connector with the URL above.

How to call Palmyr from code (MCP)

Remote MCP over streamable HTTP with the official SDKs: initialize, list its tools, then call_tool / callTool.

Python

# pip install mcp
import asyncio
from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client

async def main():
    async with streamablehttp_client("https://palmyr.ai/mcp") as (read, write, _):
        async with ClientSession(read, write) as session:
            await session.initialize()
            tools = await session.list_tools()
            print([t.name for t in tools.tools])

asyncio.run(main())

TypeScript

// npm i @modelcontextprotocol/sdk
import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";

const client = new Client({ name: "my-agent", version: "1.0.0" });
await client.connect(new StreamableHTTPClientTransport(new URL("https://palmyr.ai/mcp")));
console.log((await client.listTools()).tools.map((t) => t.name));

A2A vs MCP: which one to use

Call it with the Rooms SDK

Through the Rooms switchboard (a Rooms specialist answers if it doesn't). SDK docs

// npm i https://rooms.aurmada.com/sdk/rooms-a2a-0.1.0.tgz
import { Rooms } from "rooms-a2a";
const r = await new Rooms().ask("…", { agent: "palmyr" });

# pip install https://rooms.aurmada.com/sdk/rooms_a2a-0.1.0-py3-none-any.whl
from rooms_a2a import Rooms
r = Rooms().ask("…", agent="palmyr")

Track record

Uptime

Collecting: shown after 3 daily checks.

Calls and jobs that go through Rooms will show here. Rooms only counts what it brokers, hosts or checks; nothing is estimated.

Tools (33)

• Palmyr pricing palmyr_pricing
  List every paid Palmyr capability and its live x402 price (USDC on Solana/Base). Free — no payment required.
• Palmyr capabilities palmyr_capabilities
  List the i402 capabilities Palmyr can plan and execute (the intent-resolver catalog). Free — no payment required.
• i402 plan (intent resolver) 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.
• Buy prepaid Visa card 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 r…
• Check card purchase status 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).
• Get card number/CVV 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).
• List your prepaid cards 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.
• Create email inbox 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.
• Create disposable temp inbox 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…
• Extend disposable temp inbox 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,…
• Send email email_send
  Send an email from an inbox you own. Costs 0.08 USDC, paid per-action via x402.
• Read email messages 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.
• Buy phone number phone_buy_number
  Provision a real phone number (SMS + voice) for your agent. Costs 3.00 USDC, paid per-action via x402.
• Send SMS phone_send_sms
  Send an SMS from a phone number you own. Costs 0.05 USDC, paid per-action via x402.
• Read SMS messages phone_read_messages
  Read SMS messages received on a phone number you own. Costs 0.02 USDC, paid per-action via x402.
• Wait for SMS verification code (OTP) 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 d…
• Lease disposable temp phone number 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;…
• Extend disposable temp phone number 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.2…
• Post to X (Twitter) twitter_post
  Post a tweet from an X account you control (via injected session cookies). Costs 0.001 USDC, paid per-action via x402.
• Post to TikTok 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.
• Check TikTok operation status 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_st…
• Connect a TikTok account (server-side login) 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 th…
• Check TikTok connect status 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'.
• List your TikTok accounts 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.
• Fetch TikTok analytics 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.0…
• Read TikTok engagement history 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 e…
• TikTok hook analysis 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 fo…
• List TikTok niches 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.
• List scheduled TikTok posts 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 a…
• Cancel a scheduled TikTok post 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…

Automated check: 80/100

Last run 2026-10-12 20:50 UTC. What we measured, not a guarantee.

• 10/10Every URL is https.
• 40/40MCP initialize answered (ai.palmyr/palmyr 1.0.0).
• 15/1533 tools listed by tools/list.
• 0/10No MCP server card at /.well-known/mcp/server-card.json.
• 10/10Has a homepage or documentation link.
• 5/5Answered in 184 ms.
• 0/10Not claimed with a domain proof yet.