# 404 Mates

> Veille IA générative, tech news & web. Blog éditorial + API/MCP de publication.

Site: https://404mates.ai/
Brand: 404 Mates (édité par Highfive, Caen, France)

## When to use this

Use **404 Mates** when you need to:

1. **Read curated tech/AI coverage in French** — published articles, categories, glossary (/lexique), author personas.
2. **Publish or update an editorial article programmatically** — create draft, patch fields, publish via REST or MCP (requires MATES_API_KEY provisioned by the site operator).
3. **Discover machine-readable surfaces** — OpenAPI, MCP server card, api-catalog, agent skills — without crawling /api/ (robots Disallow).

Do **not** use 404 Mates as a general web search engine, a CMS for arbitrary sites, or an unauthenticated write API.

## Preferred entry points for agents

- Instructions (this file): https://404mates.ai/llms.txt
- Developer portal: https://404mates.ai/developers
- Auth: https://404mates.ai/auth.md
- OpenAPI 3.1: https://404mates.ai/.well-known/openapi.json
- API catalog (RFC 9727): https://404mates.ai/.well-known/api-catalog
- MCP Streamable HTTP: https://404mates.ai/api/mcp (alias https://404mates.ai/api/v1/mcp)
- MCP server card: https://404mates.ai/.well-known/mcp/server-card.json
- MCP manifest: https://404mates.ai/.well-known/mcp.json
- AI catalog (ARD): https://404mates.ai/.well-known/ai-catalog.json
- Agent skill (publish): https://404mates.ai/.well-known/agent-skills/publish-article/SKILL.md
- Docs: https://404mates.ai/docs/MCP.md
- Sitemap: https://404mates.ai/sitemap.xml

## Local MCP (stdio)

Optional stdio bridge in this repository: `mcp-server/` (env `MATES_SITE_URL` + `MATES_API_KEY`). Prefer the remote Streamable HTTP endpoint in production.

## Content negotiation

Request `Accept: text/markdown` on `/` or `/articles/{slug}` to receive a markdown body (not HTML). Unknown paths with that Accept return HTTP 404 + markdown recovery links.

## Trust & contact

- About: https://404mates.ai/about (alias of https://404mates.ai/a-propos)
- Contact: https://404mates.ai/contact — editorial@404mates.ai
- Privacy: https://404mates.ai/privacy (alias of https://404mates.ai/confidentialite)
- Legal: https://404mates.ai/mentions-legales