# List Proposals

> List on-chain Aptos Improvement Proposals (AIPs) with status, tallies, and pagination.

- Skill: `aptos-labs/list-proposals` (Agent Skill)
- Install (CLI): `npx skillmds@latest add aptos-labs/list-proposals`
- Raw SKILL.md: https://api.skillmd.com/api/skills/aptos-labs/list-proposals/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: aptos-labs (https://skillmd.com/u/aptos-labs)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/aptos-labs/list-proposals

---


# List Aptos governance proposals

Use this skill when the user wants a catalog of current or historical Aptos on-chain proposals.

## HTTP

`GET /api/proposals?page=0`

Response fields include `proposalId`, `status` (`active` | `passed` | `executed` | `failed`), `yesVotes`, `noVotes`, and verified off-chain metadata when the on-chain hash matches.

## MCP

Call tool `list_proposals` on the Streamable HTTP MCP server at `/mcp`.

## WebMCP

On the governance homepage, the browser tool `list_proposals` returns the same JSON.