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

# MCP integration

> Use authorised Marketplace tools with a Model Context Protocol client.

## The same scope as the public API

The Model Context Protocol server provides an integration interface to public Marketplace functions. It shares the keys, scopes, country restrictions and checks of the [REST API](/en/plateforme/api). It does not expose grades, payroll or private learner evidence, or grant contract decision-making powers.

## Connect a client

1. Create a developer account and generate a key through the [public API](/en/plateforme/api) journey.
2. Configure a compatible MCP client for the remote endpoint `https://api.ardoiseeduc.com/mcp` and the `Authorization: Bearer YOUR_KEY` header. The exact configuration format depends on the client; keep the key server-side.
3. List available tools, then test a read within the authorised country. Check parameters and permission before writing; do not submit a private pupil record.

## Published tools

| Tool | Scope | Purpose |
| - | - | - |
| `list_countries` | None | Configured country reference |
| `search_schools` | `marketplace:read` | Eligible public profiles within the authorised country |
| `get_school_profile` | `marketplace:read` or `school:profile` | Authorised public profile, restricted to the institution for a school key |
| `search_teachers` | `marketplace:read` | Public tutors within the authorised country |
| `list_jobs` | `marketplace:read` | Authorised job listings |
| `list_certified_partners` | `marketplace:read` | Approved partners |
| `submit_lead` | `leads:write` | Submit an eligible CRM contact |

## Countries, audit and errors

A country-scoped key cannot widen its access by requesting another country or supplying a foreign identifier. Missing authorisation denies access; omitting `country` does not grant all countries. A technical country list establishes neither an Austrian School offering nor regulatory approval.

Calls receive the service's configured tracking. Address permission errors, revoked keys or missing resources before retrying. School support requires separate explicit, temporary grants: see [partners](/en/plateforme/partenaires-certifies).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.