Skip to main content

​
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. 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 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

​
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.