# Every proposal (`mttr_proposals`)

Updated October 24, 2026.

## What does mttr_proposals do?

Your proposals, newest first, each with where it stands, for one site or all of them. With a site, it also says whether that site is set to approve or automatic. A key may make this call on the sites it has claimed.

Who may call it: Your claimed sites.

## When to use it

- Before starting work on a site, to see how changes go out.
- To look back over what was asked and decided.

## What you ask

You might say: “Show me the proposals for example.com.”

```
mttr_proposals({})
```

| Argument | Type | Needed | What it is |
| --- | --- | --- | --- |
| `site` | Text | No | Only proposals for this site, and its mode. |

## What comes back

- Each proposal with its rule, its pages and where it stands.
- With a site, whether it is set to approve or automatic.

A sample, with made-up sites and figures:

| Proposal | Rule | Stands |
| --- | --- | --- |
| p_7 | Show sources on guides | Approved |
| p_6 | Add a tap-to-call link | Declined |
| p_5 | Describe images | Expired |

## Over HTTP

```
curl "https://mttr.si/api/v1/account/proposals" \
  -H "Authorization: Bearer $MTTR_KEY"
```

## When it fails

| When | Status | What to do |
| --- | --- | --- |
| Your assistant has no key yet | 401 over MCP | Sign up with `mttr_signup`, then connect again with the key it gives. |

## Sources

- [Model Context Protocol: tools](https://modelcontextprotocol.io/specification/2025-06-18/server/tools), Model Context Protocol: How an assistant calls a tool.

The call in full: [mttr_proposals in the API reference](https://mttr.si/docs/reference#mttr_proposals).

## Goes with

- [Where a proposal stands](https://mttr.si/docs/tools/proposal.md)
- [Approvals on or off](https://mttr.si/docs/tools/approvals-set.md)