Palmyr

What Palmyr MCP server does

Palmyr MCP server provides agent-facing access to several operational services. The supported live categories include phone numbers and voice calls, email inboxes, VPS compute, domains and DNS, non-custodial wallets, ClawHub skills, and social accounts. X accounts can be purchased from a pool and used for posting, replies, likes, follows, and profile changes. TikTok accounts can be connected through a browser and QR login, then used for posting, scheduling, engagement, and profile updates.

The repository also includes a CLI for scripting these operations. Examples include searching for a phone number, creating an email inbox, deploying and connecting to a VPS, buying a domain, and publishing to X. Output can be forced into JSON for agent workflows, and command exit codes can be used for branching.

How it works

Palmyr uses wallet-based authorization and per-action x402 payments. A client first calls an endpoint and receives a 402 response describing the required payment. It then sends a USDC payment payload in the request, after which the service verifies the transaction and returns the result. Solana mainnet and Base are supported.

The wallet that pays for a resource becomes its owner. The README describes this as replacing API keys and signup with a wallet identity. The repository also documents i402, an optional client-side orchestrator. Given an outcome and budget, it returns a sequence of x402 calls; the wallet signs and pays for each step directly. The server does not hold the funds in escrow.

Setup and configuration

The CLI requires Node.js 22 or newer. Install it globally with npm i -g @palmyr/cli, or invoke it through npx @palmyr/cli. A local wallet can be created with palmyr wallet create; the generated wallet supports Solana and Base payments. JSON output can be enabled with --json or PALMYR_JSON=1.

To self-host the repository, clone it, copy .env.example to .env, install dependencies, build, and start the application. The documented required variables are TELNYX_API_KEY, HCLOUD_TOKEN, NAMECHEAP_API_KEY, and NAMECHEAP_API_USER. These configure the phone, compute, and domain provider connections used by the application.

Tools and capabilities

The documented CLI capabilities include:

• Search for and provision phone numbers, send SMS, and handle voice functions such as text-to-speech, DTMF, recording, transfer, and gather.
• Create and use email inboxes with encrypted storage options.
• Deploy hardened Hetzner VPS instances, select among six datacenters, install agent recipes, and connect over SSH.
• Buy domains and manage DNS.
• Use Base and Solana non-custodial smart wallets with spending limits.
• Install skills from a catalog of more than 3,500 ClawHub entries.
• Buy and operate X accounts, or connect TikTok accounts for social actions.
• Ask the i402 orchestrator to plan and execute a multi-step sequence within a budget.

Limitations and notes

Palmyr MCP server charges for paid operations in USDC; the README lists example prices but notes that domain pricing is dynamic. Some listed services are not live: the crypto card, physical address, Reddit and LinkedIn support, and S3-compatible storage are marked pending.

The i402 workflow is client-side execution only. Each planned action requires a separate wallet-signed x402 payment. Email encryption differs by ownership: inboxes associated with a Solana key use NaCl box encryption, while other inboxes use AES-256-GCM encryption at rest. Social-account features also differ by platform: X accounts can be purchased, while TikTok requires connecting an existing account through browser-based login.