# A link to your progress page (`mttr_progress_link`)

Updated October 24, 2026.

## What does mttr_progress_link do?

A private link to your progress page: your sites, every read, what each changed, and what your assistant has asked. It lapses after the days asked, or when the key is rotated. A key may make this call on the sites it has claimed.

Who may call it: Your claimed sites.

## When to use it

- You want to see the work in a browser.
- You want to check on what your assistant did.

## What you ask

You might say: “Give me a link to my progress page.”

```
mttr_progress_link({ days: 7 })
```

| Argument | Type | Needed | What it is |
| --- | --- | --- | --- |
| `days` | Number | No | How many days the link lasts, from 1 to 90. |

## What comes back

- A link of the form /p/…, signed with your key.
- How many days it lasts: 30 if none are asked, 90 at most.

A sample, with made-up sites and figures:

```
https://mttr.si/p/a1b2c3.1767225600.Xk9…
Lasts 30 days. Hand it only to the person.
```

## Over HTTP

```
curl -X POST "https://mttr.si/api/v1/account/link" \
  -H "Authorization: Bearer $MTTR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"days":7}'
```

## 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_progress_link in the API reference](https://mttr.si/docs/reference#mttr_progress_link).

## Goes with

- [Your work board](https://mttr.si/docs/tools/todo.md)
- [Log what you did](https://mttr.si/docs/tools/log-work.md)