ai.palmyr/palmyr

Official14 tools

by 0xArtex · TypeScript

Palmyr

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

Infrastructure tools for email, phone, domains, and wallets with per-action crypto payments.

Captured live from the server via tools/list.

palmyr_pricing

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

No parameters.

palmyr_capabilities

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

No parameters.

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.

Parameters (8)

intentstringrequired
Natural-language outcome, e.g. 'register a .com and set up email on it'
budget_usdcnumberrequired
Max total USDC to spend across the whole plan
paramsobject
Optional structured parameters for the intent
deadline_secondsnumber
qualitystring
Optional quality hint, e.g. 'fast' | 'best'
constraintsobject
allow_budget_exceededboolean
Return an executable plan even if it exceeds budget_usdc
paymentstring
base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions

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.

Parameters (5)

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

email_send

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

Parameters (6)

inbox_idstringrequired
Inbox id returned by email_create_inbox
tostringrequired
Recipient email address
subjectstringrequired
bodystringrequired
htmlstring
paymentstring
base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions

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.

Parameters (4)

inbox_idstringrequired
Inbox id returned by email_create_inbox
limitnumber
Page size (default 50, max 200)
cursorstring
id of the last message from the previous page
paymentstring
base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions

phone_buy_number

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

Parameters (3)

countrystringrequired
ISO-2 country code, e.g. 'US'
areaCodestring
paymentstring
base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions

phone_send_sms

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

Parameters (4)

number_idstringrequired
Phone number id returned by phone_buy_number
tostringrequired
Recipient number in E.164, e.g. '+15551234567'
bodystringrequired
paymentstring
base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions

phone_read_messages

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

Parameters (2)

number_idstringrequired
Phone number id returned by phone_buy_number
paymentstring
base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions

twitter_post

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

Parameters (6)

account_idstringrequired
Your identifier for the X account
cookiesarrayrequired
Non-empty array of session cookies for the X account
textstringrequired
Tweet text
proxy_session_idstring
community_idstring
paymentstring
base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions

tiktok_post

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

Parameters (9)

account_idstringrequired
Your identifier for the TikTok account
cookiesarrayrequired
Non-empty array of session cookies for the TikTok account
captionstringrequired
video_base64string
Base64 video bytes — only fits tiny clips (the MCP transport caps request bodies at 1mb); prefer video_url
video_urlstring
Public URL to the video (preferred; no size limit)
proxy_session_idstring
countrystring
privacystring
paymentstring
base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions

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.

Parameters (1)

domainstringrequired
A full domain (example.com) or a bare name (example)

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.

Parameters (2)

domainstringrequired
Full domain to register, e.g. 'example.com'
paymentstring
base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions

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.

Parameters (7)

namestringrequired
Server name
serverTypestringrequired
Hetzner server type, e.g. 'cx22'
imagestring
OS image (default 'ubuntu-24.04')
locationstring
installany
Recipe name(s) to install, e.g. 'openclaw'
sshPublicKeystring
paymentstring
base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions

README.md9 KBView on GitHub

Palmyr

Everything your AI agent needs — one CLI.

Phone, email, compute, domains, wallets, X accounts, and more. Pay with USDC. Your wallet is your identity.

Quick Start • Services • Dashboard • Skill File • Docs

</div>

Stop asking your human for a credit card.

Quick Start

CLI

bash

npm i -g @palmyr/cli
palmyr wallet create                      # local HD wallet, both Solana + Base, ready to pay

palmyr phone search --country US
palmyr email create --name my-agent --wallet SOL_PUBKEY
palmyr compute deploy --type cx23 --json  # auto-key, auto-wait, verified ssh — JSON out
palmyr compute ssh my-vps                 # drop into the new box
palmyr domain buy --name myagent.dev
palmyr twitter buy                        # $5 USDC → ready X account from the pool
palmyr twitter post @handle --body "gm"   # post immediately, no setup

Agents: pipe stdout into jq, branch on $? against the exit code table. Force JSON on a TTY with --json or PALMYR_JSON=1.

Or run without installing: npx @palmyr/cli phone search --country US

Skill File

Add to your OpenClaw / Claude Code agent: palmyr.ai/skill.md

Dashboard

Visual node-based agent deployment: palmyr.ai/dashboard.html

Services

Service	Status	Cost (USDC)
Phone	✅ Live	$3/number, $0.05/SMS, $0.10/call
Voice Calls	✅ Live	TTS, DTMF, record, transfer, gather
Email	✅ Live	$2/inbox. E2E (NaCl box) when owned by a Solana key; otherwise AES-256-GCM encrypted at rest
Compute	✅ Live	$5–64/mo VPS + $6 one-time deploy fee. SSH hardened, choice of agent install recipe (`--install hermes`, `--install openclaw`, ...), location selection across 6 Hetzner datacenters.
Domains	✅ Live	Dynamic pricing, DNS management included
Wallet	✅ Live	Non-custodial smart wallets on Base + Solana
Skills	✅ Live	3500+ from ClawHub, one-click install
Social Media Accounts	✅ Live (X + TikTok)	X: buy ready accounts ($5), post / reply / like / follow / update bio, name, pfp, banner, username. TikTok: connect your own via a one-shot real-browser / QR login, then post / schedule / follow / like / delete / update bio, name, avatar. Sticky residential IP per account.
i402 orchestrator	✅ Live	Tell Palmyr what you want, it plans + executes a sequence of x402 calls. See `spec/i402.md`.
Crypto Card	🟡 Pending	Visa debit linked to agent wallet
Address	🟡 Pending	Physical mailing address for the agent
Reddit / LinkedIn	🟡 Pending	Same model as X — buy + operate from the CLI
Storage	🟡 Pending	S3-compatible object storage

How It Works

code

Agent calls API → gets 402 → pays USDC (Solana or Base) → service provisioned

Your wallet is your identity. Pay with USDC, your wallet address owns the resource. No API keys. No signup.

Three ways to use Palmyr

1. Call any endpoint → get 402 → pay with USDC → done

bash

# Provision a phone number ($3 USDC)
curl -X POST https://palmyr.ai/phone/numbers \
  -H "Content-Type: application/json" \
  -d '{"country": "US"}'
# → 402 Payment Required (tells you exactly how to pay)

# Pay via x402 — your wallet address becomes the owner
curl -X POST https://palmyr.ai/phone/numbers \
  -H "X-PAYMENT: <base64-encoded x402 payment payload>" \
  -H "Content-Type: application/json" \
  -d '{"country": "US"}'
# → phone number provisioned, owned by your wallet

Same wallet that provisions a resource is the only wallet that can access it. No API keys or tokens. Your agent wallet = your identity.

2. Or ask for an outcome with i402 — plan + execute client-side

bash

# Tell Palmyr what you want, not how. It returns a plan of x402 calls;
# your wallet signs and executes each one itself.
palmyr chat run "Launch a sneaker resale brand for US teens" --budget 60 --execute

# What you get back:
#   Plan: 5 steps  $45.09 total
#     s1 register_domain → palmyr.register_domain  $9.99
#     s2 deploy_vps → palmyr.deploy_vps    $6.00
#     s3 provision_email_inbox → palmyr.provision_email_inbox  $1.00
#     s4 social_account_provision → palmyr.x_account  $15.00
#     s5 social_post → palmyr.x_post       $0.50
#     orchestration fee (15%):  $3.75
#   Executing plan (client-side, one x402 tx per step)...
#   → s1 register_domain via palmyr.register_domain ($9.99)
#   ✓ s1 done in 18400ms
#   → s2 deploy_vps via palmyr.deploy_vps ($6.00)
#   ✓ s2 done in 62000ms
#   ...
#   done: completed  spent=$45.09

Multi-turn follow-ups are wallet-keyed: the server extracts your wallet from the x402 signature, finds your last active session, and (if the Haiku classifier decides the new intent continues it) extends that session — "now post 3 TikTok videos about launch week" references the brand you just launched without re-provisioning. Full spec at spec/i402.md.

Architecture note: i402 v0.1 is agent-side-execution-only. The server returns a plan of x402 endpoints; your wallet signs every step's payment directly. No custodial escrow, no server-held USDC.

3. Or use the dashboard

palmyr.ai/dashboard — visual node-based agent management.

x402 Payment

All paid endpoints accept USDC via the x402 protocol:

Call any endpoint → get 402 with PAYMENT-REQUIRED header
Build a USDC transfer to the treasury
Send it in the X-PAYMENT header (canonical x402 v2; Payment-Signature is also accepted as a legacy alias)
Server verifies onchain → returns the response

Networks: Solana mainnet + Base (EVM) Treasury (SOL): B1YEboAH3ZDscqni7cyVnGkcDroB2kqLXCwLs3Ez8oX3 Treasury (EVM): 0x7fA8aC4b42fd0C97ca983Bc73135EdbeA5bD6ab2

AgentWallet

Non-custodial smart wallets with onchain spending limits, secured by passkey (FaceID/fingerprint).

bash

npx @agntos/agentwallet create        # Deploy on Base + Solana
npx @agntos/agentwallet status 0xABC  # Check balances & limits
npx @agntos/agentwallet send \
  --wallet 0xW --to 0xR --amount 10 --key 0xK

On-chain daily + per-tx + per-token limits
Passkey (biometric) is the owner key — can't be phished
Agent can't change its own limits
Source: github.com/0xArtex/agentwallet-aos

Dashboard

Visual node-based dashboard at palmyr.ai/dashboard.html:

Agent node → spawns Model, Channel, VPS nodes
AI Model → configure Anthropic/OpenRouter/OpenAI, pushes to VPS
Channel → Telegram/Discord with pairing code auth
VPS → one-click deploy with OpenClaw pre-installed
Skills → browse 3500+ from ClawHub, bulk install
Wallet → non-custodial smart wallet with on-chain limits

All nodes push config independently to the VPS. Delete a node → removes config from VPS.

Tech Stack

Runtime: Node.js + TypeScript + Express
Payments: x402 (USDC on Solana + Base)
Phone/Voice: Telnyx (150+ countries)
Email: Mailgun (send + inbound routing). E2E (NaCl box) when the inbox is keyed to a Solana wallet; otherwise AES-256-GCM encrypted at rest
Compute: Hetzner Cloud + cloud-init hardening
Domains: Namecheap API
Wallet: Solidity (Base) + Anchor (Solana)
Database: SQLite (better-sqlite3)

Self-Host

bash

git clone https://github.com/0xArtex/Palmyr
cd Palmyr
cp .env.example .env  # configure keys
npm install
npm run build
npm start

Required env vars: TELNYX_API_KEY, HCLOUD_TOKEN, NAMECHEAP_API_KEY, NAMECHEAP_API_USER

License

MIT

Install

claude_desktop_config.json

{
  "mcpServers": {
    "palmyr": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://palmyr.ai/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.