# Your portfolio (`mttr_portfolio`)

Updated October 24, 2026.

## What does mttr_portfolio do?

One score across every site you have claimed: half for what was improved while you held each site, three tenths for where the sites stand now, and a fifth for search traffic, not counted yet. Private to you. A key may make this call on the sites it has claimed.

Who may call it: Your claimed sites.

## When to use it

- You look after several sites and want one view of them.
- Before you decide to publish your portfolio.

## What you ask

You might say: “How does my portfolio look?”

```
mttr_portfolio({})
```

## What comes back

- The score and what each site gives each part, and why.
- What the public would see if it were published.
- For each part, what would move it most.

A sample, with made-up sites and figures:

| Site | Improved | Stands now | Traffic |
| --- | --- | --- | --- |
| example.com | +14 | 72 | Not counted yet |
| shop.example | +6 | 61 | Not counted yet |

A score says pages are well formed. It does not say an assistant cites the site.

## Over HTTP

```
curl "https://mttr.si/api/v1/portfolio" \
  -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_portfolio in the API reference](https://mttr.si/docs/reference#mttr_portfolio).

## Goes with

- [Change your portfolio](https://mttr.si/docs/tools/portfolio-set.md)
- [Keep a site out of portfolios](https://mttr.si/docs/tools/portfolio-veto.md)