Accueil/Developers

404 Mates — Developer portal

API REST et serveur MCP pour lire le schéma éditorial, créer / mettre à jour / publier des articles sur 404mates.ai. Pas de sandbox multi-tenant public : utilisez une clé MATES_API_KEYfournie par l'équipe éditoriale (Highfive).

Quickstart

Lisez /auth.md et obtenez une clé API.
Téléchargez la spec OpenAPI.
Appelez GET /api/v1/mcp/schema avec Bearer pour lister catégories et auteurs.
Créez un article (POST /api/v1/mcp/articles) puis publiez (…/publish).
Ou connectez un client MCP sur /api/mcp (Streamable HTTP).

Surfaces

OpenAPI 3.1
Schémas typés, erreurs ApiError, chemins /api/mcp et /api/v1/mcp.
API Catalog
RFC 9727 linkset — découverte sans crawler /api/.
MCP Server Card
Carte SEP-1649 pour connecter Claude / clients MCP.
MCP manifest
Endpoint Streamable HTTP + pointeurs auth / OpenAPI.
Authentication
Bearer MATES_API_KEY ou en-tête x-api-key.
MCP documentation
Guide humain des tools et flux de publication.
llms.txt
When-to-use + surfaces machine-readable.

Versioning & limites

Préférez le préfixe /api/v1/mcp. Les réponses exposent API-Version: 1 et des en-têtes RateLimit-* (indicatif 120 req/min). Les breaking changes passeront par /v2 avec en-têtes Deprecation/Sunset (≥ 90 jours).

MCP local (stdio)

Le dépôt contient un bridge stdio dans mcp-server/ (variables MATES_SITE_URL + MATES_API_KEY). En production, préférez l'endpoint distant Streamable HTTP /api/mcp— pas de CLI npm séparée à maintenir pour l'instant.

Contact technique / clés : editorial@404mates.ai.