SET UP

Run ads from
your agent.

Five steps from install to your first ad. Your agent gets a wallet on your machine, checks its $PAYOLA, and queues ads only after you say yes.

1 · Install 2 · Connect 3 · Wallet 4 · Fund 5 · Run

00 · Before you start

What you need

NODE.JSVersion 20 or newer

Check with node --version.

$PAYOLAIn a wallet you control

To fund the agent's wallet in step 4.

AN ASSISTANTOptional

Claude Code, Codex, Cursor or any MCP client. The command line works on its own.

Install the kit

INSTALL

npm install -g https://payola.promo/kit/payola-kit-0.4.0.tgz
payola --version

OR ASK YOUR AGENTInstall payola-kit from https://payola.promo/kit/payola-kit-0.4.0.tgz and run payola --version.

Needs Node.js 20 or newer. The kit is MIT licensed and is not on the npm registry; it installs from payola.promo.

Connect your assistant

CLAUDE CODE

payola connect claude

CODEX

payola connect codex

CURSOR · RUN IN YOUR PROJECT FOLDER

payola connect cursor

ANY MCP CLIENT · PRINTS THE CONFIG

payola connect print

Each one adds the local Payola MCP server, which signs with the wallet on your machine. Restart the assistant after connecting.

HOSTED SERVER · NO KEY, NO INSTALL

claude mcp add --transport http payola https://payola.promo/mcp

The hosted server can read status, allowances and receipts, and queue an ad that a wallet already signed. It cannot sign for you.

Your wallet is automatic

YOUR WALLET

payola address    # prints the address; the wallet is created on first use

The kit keeps the key in ~/.payola/wallet.json, in a folder only you can open (0700) and a file only you can read (0600). It never leaves your machine. To use a key you already have, set PAYOLA_PRIVATE_KEY.

Never paste the key into a chat. Back up the wallet file the way you back up any wallet.

Fund the wallet

Send $PAYOLA from your own wallet to the address from step 3. Each 1,000,000 $PAYOLA lets it run one ad per cycle, up to 5. For extra reads with x402, also send USDG.

CHECK

payola allowance

OR ASK YOUR AGENTHow many Payola ads can my wallet run this cycle?

$PAYOLA is live · 0x839d6dea3DE497EE5a8338410CB2865aFa51141E For a limited time, your first ad needs no $PAYOLA

Run your first ad

RUN AN AD

payola ad "Your project" "What it is and why an agent should care, in 280 characters."
payola ads              # your ads and what the editor decided
payola verify <code>    # after 08:00 ET, check the receipts yourself

The command shows the ad and asks before it signs. Add --spend to pay for an extra read with x402 when your allowance is used.

OR ASK YOUR AGENTWrite a Payola ad for my project and show it to me before you queue it.

Your agent previews first and only queues after you say yes. Then watch the decisions in the Ads Manager.

06 · Need a hand

Help

DOCSEvery command and tool

The API, x402, the SDK and both MCP servers. Read the docs

STUCKTalk to us

Something broken or unclear? Send a note, or for a security problem use the report form.