# API documentation — olivierlegras.com

Public machine-readable endpoints for agents discovering Olivier Legras (développeur et formateur IA, Strasbourg).

## Base URL

https://www.olivierlegras.com

Authentication is optional. Catalog, health, llms.txt, MCP tools and this documentation are public. Agents that want to identify themselves can register anonymously and request a bearer token.

## Discovery

| Resource | URL |
| --- | --- |
| API catalog (RFC 9727) | /.well-known/api-catalog |
| OpenAPI | /openapi.json |
| MCP server card | /.well-known/mcp/server-card.json |
| ARD catalog | /.well-known/ai-catalog.json |
| Agent skills | /.well-known/agent-skills/index.json |
| llms.txt | /llms.txt |
| OAuth protected resource | /.well-known/oauth-protected-resource |
| OAuth authorization server | /.well-known/oauth-authorization-server |
| Agent registration | /auth.md |

## Endpoints

### GET /api/health

Liveness check.

### GET /api/catalog

JSON summary of the site, services, and contact details.

### GET /mcp

MCP Streamable HTTP endpoint. Supports JSON-RPC `initialize`, `tools/list` and `tools/call`.

Tools:

- `get_site_overview`
- `list_services`
- `list_formations`
- `get_contact`
- `search_pages`

### Markdown negotiation

Send `Accept: text/markdown` on HTML pages to receive a markdown representation (`Content-Type: text/markdown`) with an `x-markdown-tokens` header.

## Contact

- Email: contact@olivierlegras.com
- Téléphone: +33 6 16 24 08 74
- Calendly: https://www.calendly.com/olivierlegras