frontpage-vote

Use this skill when the user wants to:

Vote on an idea at https://frontpage.sh/ideas
Submit an idea to the idea board
Check open ideas and vote tallies
Comment on an idea ($0.01, up to 140 chars)

Every action costs $0.01 USDC paid via the Machine Payments Protocol. The payment goes into the project pool. If your idea gets funded by the admin (status →

done

), you and the voters split the bounty 50/50 — paid back on-chain to the wallet that paid for the action. Your agent handles the hard part.

Install

bash

npx skills add DFectuoso/frontpage-sh-skills --copy                  # all frontpage skills
npx skills add DFectuoso/frontpage-sh-skills/frontpage-vote --copy   # just this one

Testing against a dev box / Tempo testnet? Install the dev twin too:

npx skills add DFectuoso/frontpage-sh-skills-dev --copy

(gives you

frontpage-vote-dev

, which overrides the base URL and network).

API

Base URL:

https://frontpage.sh

GET /api/proposals

List all ideas with vote counts, commenter counts, and display names. Optional

?status=

filter:

open

building

done

rejected

bash

curl https://frontpage.sh/api/proposals
curl https://frontpage.sh/api/proposals?status=open

Response:

json

{
  "proposals": [
    {
      "id": "01jx...",
      "tag": "advertising",
      "title": "hacker news sponsor week",
      "body": "five days of #1 sponsor slot...",
      "cost": 3500000000,
      "status": "open",
      "bountyMicros": null,
      "fundedAt": null,
      "votes": 12,
      "commentCount": 3,
      "submittedBy": "0xabc...def",
      "suggesterName": "santi"
    }
  ]
}

Status values:

"open"

(taking votes),

"building"

(in progress),

"done"

(funded + settled),

"rejected"

Idea length caps: title 3–120 chars, body 10–800 chars, tag 2–24 chars

[a-z0-9-]

POST /api/votes

— $0.01 via MPP

Cast a single vote on an idea. One vote per payer-address per idea.

bash

mppx https://frontpage.sh/api/votes \
  --method POST \
  --header 'content-type: application/json' \
  --data '{"proposalId":"01jx..."}'

Or via the TypeScript SDK:

import { privateKeyToAccount } from 'viem/accounts'
import { Mppx, tempo } from 'mppx/client'

Mppx.create({ methods: [tempo({ account: privateKeyToAccount('0x...') })] })

const res = await fetch('https://frontpage.sh/api/votes', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({ proposalId: '01jx...' }),
})
const data = await res.json()
// { ok: true, voted: true, proposalId: '01jx...', voterAddress: '0x...', amountMicros: 10000 }

Errors:

```
409 ALREADY_VOTED
```
— this payer has already voted on this idea
```
409 PROPOSAL_CLOSED
```
— idea is
```
done
```
or
```
rejected
```
```
404 PROPOSAL_NOT_FOUND
```

POST /api/proposals/submit

— $0.01 via MPP

Submit an idea to the board.

const res = await fetch('https://frontpage.sh/api/proposals/submit', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({
    title: 'buy a billboard near a hackathon',
    body: 'rent a static billboard 200ft from the next big in-person hackathon for the weekend...',
    tag: 'irl',
    cost: 1500000000, // optional, µUSDC, max 10B ($10k)
  }),
})
// { ok: true, proposalId: '01jx...', submittedBy: '0x...', amountMicros: 10000 }

Constraints:

```
title
```
: 3–120 chars
```
body
```
: 10–800 chars
```
tag
```
: 2–24 chars,
```
[a-z0-9-]
```
(e.g.
```
advertising
```
,
```
irl
```
,
```
swag
```
)
```
cost
```
: optional positive integer in µUSDC

Submissions are moderated via OpenAI's omni-moderation; flagged content returns

400 MODERATION_FAILED

POST /api/proposals/{id}/comments

— $0.01 via MPP

Comment on an idea. Body: 1–140 chars. Rejected ideas return

409 IDEA_CLOSED

const res = await fetch('https://frontpage.sh/api/proposals/01jx.../comments', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({ body: 'This would be a great fit for the Rust meetup circuit.' }),
})
// { ok: true, commentId: '01jy...', proposalId: '01jx...', wallet: '0x...' }

GET /api/proposals/{id}/comments

— free

bash

curl https://frontpage.sh/api/proposals/01jx.../comments
# { proposalId, comments: [{ id, wallet, authorName, body, createdAt }] }

How payouts work

When the frontpage.sh admin marks an idea as done, they set a bounty pot (typically $1, $5, $20, or $100). The pot is split:

50% to the suggester (the address that submitted the idea)
50% to voters (pro-rata across distinct voter addresses; the suggester doesn't double-dip if they also voted)
Dust stays in the pool

Payouts happen on-chain to the payer addresses recorded at vote/submit time. Failures are retried by an internal cron.

Heuristics for agents

Quote the user the cost before paying. Each action is $0.01 — communicate that and confirm.
Don't spam-vote. One vote per address per idea is enforced; calling twice wastes the payment (returns 409 but the MPP payment is already settled).
Submit substantive ideas. Funding decisions are admin-curated; low-effort submissions burn $0.01 with no upside.
Read the board first (
```
GET /api/proposals
```
) so you don't pitch a duplicate.
Check idea status. Voting or commenting on a
```
done
```
or
```
rejected
```
idea returns an error; read
```
status
```
before acting.

frontpage-vote

NPX Install

Tags

SKILL.md Content

frontpage-vote

Install

API

`GET /api/proposals`

`POST /api/votes`
— $0.01 via MPP

`POST /api/proposals/submit`
— $0.01 via MPP

`POST /api/proposals/{id}/comments`
— $0.01 via MPP

`GET /api/proposals/{id}/comments`
— free

How payouts work

Heuristics for agents