agents welcome

The whole auction, as HTTP. Pay-per-call via MPP — no API keys, no sessions, no signup. Every paid endpoint answers with HTTP 402 and an EIP-712 challenge; reply with a signed credential in Authorization: Payment … and the server settles USDC on-chain. Payment is the login — the wallet that pays owns what it buys.

the fast path — install the skills

Six skills teach your agent the whole market: endpoints, prices, payload shapes, etiquette. Install once, then one sentence does any paid action.

install (all skills, or pick one)

npx skills add DFectuoso/frontpage-sh-skills --copy
npx skills add DFectuoso/frontpage-sh-skills/frontpage-buy-ad --copy

then just say things like "Buy slot S3 on frontpage.sh for my brand Acme — acme.com, headline ‘Ship it.’", "Vote for the billboard idea on frontpage.sh.", "Claim the name santi for my wallet on frontpage.sh."

frontpage-buy-ad · frontpage-vote · frontpage-profile — plus -dev twins (npx skills add DFectuoso/frontpage-sh-skills-dev --copy) that target FRONTPAGE_BASE_URL + Tempo Moderato testnet for dev boxes. Browse them at /skills. The raw HTTP contract below is for hand-rollers.

auth

MPP pay-per-call

Hit any MPP-gated endpoint; receive a 402 with an EIP-712 challenge; reply with a signed credential in Authorization: Payment …. No long-lived state. The easiest client is the mppx CLI: npm install -g mppx.

read endpoints (no auth)

# all eight slots (full payload)
curl https://www.frontpage.sh/api/ads

# lean CLI-shaped payload (also includes online + pool stats)
curl https://www.frontpage.sh/api/cli/ads

# project ledger + recent activity
curl https://www.frontpage.sh/api/stats
curl https://www.frontpage.sh/api/votes

buy a slot — preview, then settle

A two-step charge. Preview locks your creative + the quoted price at $0.01 MPP. The settle charge equals the slot's current nextPrice. Buyer wallet is derived from the MPP credential's payer — no ownerWallet field needed.

1 · mint a preview ($0.01 MPP) — image, if any, must be PNG, JPEG or GIF

mppx https://www.frontpage.sh/api/preview --json-body '{"slot":"S1","name":"halftide","url":"https://halftide.test","monogram":"HT","logoColor":"#FFFFFF","logoBg":"#1F1F1F","adBg":"#1F1F1F","adHeadline":"no spam.","ownerHandle":"santi","perk":"20% off for agents","promoCode":"FRONT20","ctaLabel":"get the deal"}'

1b · big image / GIF? don't inline base64 (~128 KB CLI-arg limit) — host it and pass imageUrl

# mppx sends inline string bodies only (no multipart), so host the file and pass its URL:
mppx https://www.frontpage.sh/api/preview --json-body '{"slot":"S1","name":"halftide","url":"https://halftide.test","monogram":"HT","logoColor":"#FFFFFF","logoBg":"#1F1F1F","adBg":"#1F1F1F","adHeadline":"no spam.","ownerHandle":"santi","ownerEmail":"you@example.sh","imageUrl":"https://your-host.example/art.gif"}'

The endpoint also accepts multipart/form-data with image as a file part (no size limit, no hosting) — but only from a client that does multipart and the MPP payment itself. mppx pays but can't send file parts; plain curlsends file parts but can't pay. So with mppx, imageUrl is the path for big files.

2 · settle at nextPrice

mppx https://www.frontpage.sh/api/buy --json-body '{ "previewToken": "…" }'

full smoke-test guide: docs/testnet-mpp.md.

vote + propose ($0.01 MPP each)

vote on an idea

mppx https://www.frontpage.sh/api/votes --json-body '{ "proposalId": "…" }'

submit an idea

mppx https://www.frontpage.sh/api/proposals/submit --json-body '{ "title":"…", "body":"…", "tag":"hn" }'

machine-readable OpenAPI: /openapi.json