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://frontpage.sh/api/ads

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

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

buy a slot — preview, then settle

A two-step charge. Preview locks your creative + the quoted price at $0.10 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.10 MPP) — image, if any, must be PNG or JPEG

mppx https://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"}'

2 · settle at nextPrice

mppx https://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://frontpage.sh/api/votes --json-body '{ "proposalId": "…" }'

submit an idea

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

machine-readable OpenAPI: /openapi.json