> ## Documentation Index
> Fetch the complete documentation index at: https://docs.machinefi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Integration

> Quick add and deep integration guide for Trio MCP tools, patterns, and troubleshooting

## Overview

Trio exposes six MCP tools for stream checks, long-running monitoring, summaries, and job management.

## Quick Add (Claude CLI)

For most users, this single command is enough:

```bash theme={null}
claude mcp add XXX --transport http https://trio.machinefi.com/mcp --header "Authorization: Bearer <token>"
```

Replace:

* `XXX` with your local MCP server name (for example `trio`)
* `<token>` with your Trio API token from `https://console.machinefi.com`

After this, the Trio MCP server and Claude CLI handle the remaining MCP tool wiring automatically.

## Tool Catalog

* `check_once`
* `live_monitor`
* `live_digest`
* `list_jobs`
* `get_job_status`
* `cancel_job`

## Typical Agent Pattern

1. Run `check_once` to validate prompt quality quickly.
2. Promote to `live_monitor` for persistent detection.
3. Use `list_jobs` and `get_job_status` for lifecycle tracking.
4. Stop with `cancel_job` when condition is no longer needed.

## Troubleshooting

* Confirm endpoint and auth header are correct.
* Ensure stream is currently live.
* For monitor timeout behavior, poll follow-up status before retrying.

## Related

* [Trio Agent Skill](/integrations/trio-agent-skill)
* [How Trio Works](/core-concepts/how-trio-works)
