---
name: samio-setup
description: Connect the Samio for Schools MCP server and, when the user is a teacher, link their Samio account. Use when the samio tools are missing, a tool answers "requires connecting your Samio for Schools account", or the user asks how to set Samio up.
---

# Setting up Samio for Schools

## What the server is
`https://mcp.samiolearning.com/mcp` — a remote MCP server (Streamable HTTP). Four tools work without any account: `list_countries_grades_subjects`, `search_curriculum_standards`, `get_curriculum_unit`, `get_pricing_for_country`. The teacher tools (`list_my_classes`, `create_topic_plan`, `get_topic_plan`, `get_topic_plan_week`, `generate_teaching_material`, `get_teaching_material`, `generate_challenge`, `get_challenge`, `search_knowledge_facts`, `get_class_curriculum_progress` …) need the user's Samio for Schools account.

## Steps
1. If no `samio` tools are available, add the server: Claude Code `claude mcp add --transport http samio https://mcp.samiolearning.com/mcp`; claude.ai → Customize → Connectors → Add custom connector with that URL; ChatGPT → Settings → Connectors → Create.
2. Call `list_countries_grades_subjects` once to confirm the connection works.
3. When a teacher tool answers that the account must be connected, tell the user to click **Connect** (or **Authenticate**) on the Samio connector: a Samio page opens, they sign in with their Samio for Schools login (the same as the dashboard at schools.samiolearning.com), review the requested permissions and approve. Then retry the tool.
4. Never ask the user for their Samio password in chat. The login always happens on samiolearning.com.

## Permissions the user will see
`classes:read` (class names and student counts, never student names), `plans:write`, `materials:write`, `challenges:write`, `knowledge:read`, `analytics:read` (class-level curriculum coverage only). The user can revoke access at any time in the dashboard under Settings → Connected apps.