# Aptos Governance API

Public JSON API for on-chain Aptos Improvement Proposals (AIPs). HTML UI: https://governance.aptosfoundation.org/

## Authentication

Read endpoints are public. Voting is **not** exposed here: users sign `0x1::aptos_governance` transactions in a wallet. Agent registration: https://governance.aptosfoundation.org/auth.md

## Endpoints

- `GET /api/health` — liveness
- `GET /api/proposals?page=0` — newest-first list (20 per page)
- `GET /api/proposals/{id}` — one proposal plus first votes page
- `GET /api/proposals/{id}/votes?page=0` — voter breakdown

OpenAPI: https://governance.aptosfoundation.org/openapi.json

## MCP

Streamable HTTP: `POST https://governance.aptosfoundation.org/mcp`
Server card: https://governance.aptosfoundation.org/.well-known/mcp/server-card.json

## Discovery

- API catalog: https://governance.aptosfoundation.org/.well-known/api-catalog
- ARD catalog: https://governance.aptosfoundation.org/.well-known/ai-catalog.json
- Skills: https://governance.aptosfoundation.org/.well-known/agent-skills/index.json