# orchestrator

Orchestrator is a **prompt-first router** that selects the next MCP server based on user intent.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add zoro/orchestrator

# Browse available tools
npx -y @smithery/cli@latest tool list zoro/orchestrator

# Get full schema for a tool
npx -y @smithery/cli@latest tool get zoro/orchestrator orchestrator.server_catalog

# Call a tool
npx -y @smithery/cli@latest tool call zoro/orchestrator orchestrator.server_catalog '{}'
```

## Direct MCP Connection

Endpoint: `https://orchestrator--zoro.run.tools`

**Optional config:**
- `token` (query) — Zoro user token linked to your email address

## Tools (10)

- `orchestrator.server_catalog` — Return MCP endpoints and recommended server keys.
- `orchestrator_server_catalog` — Return MCP endpoints and recommended server keys.
- `orchestrator.landing_routes` — Public no-token routes to start the experience.
- `orchestrator_landing_routes` — Public no-token routes to start the experience.
- `orchestrator.summary` — Cross-domain snapshot: which goals/wealth areas have data + tokenized deep links.
- `orchestrator_summary` — Cross-domain snapshot: which goals/wealth areas have data + tokenized deep links.
- `orchestrator.onboarding` — Onboarding payload (requires token). Returns profile/shared_data + next deep links.
- `orchestrator_onboarding` — Onboarding payload (requires token). Returns profile/shared_data + next deep links.
- `orchestrator.send_magic_link` — Send magic link email so the user can open a path with their token (uses /api/auth/send-magic-link).
- `orchestrator_send_magic_link` — Send magic link email so the user can open a path with their token (uses /api/auth/send-magic-link).

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get zoro/orchestrator <tool-name>
```

## Resources

- `zoro://orchestrator/docs` — How orchestrator is used

## Prompts (3)

- `start_here` (goal, has_token) — Route the user to the right MCP server
- `onboarding_email_link` (email, redirectPath, confirm_send) — Onboard user and send access link by email
- `review_progress` (token) — Summarize wealth and goals progress