# Prompedia

> La bibliothèque communautaire des prompts d'IA — consulte, copie, note, versionne et forke les meilleurs prompts.

Prompedia is a community library of AI prompts. Anything below works without a key for
reading; writing (publishing or editing prompts) needs a personal API key, created at
https://xn--prompdia-f1a.com/account, and the write is attributed to that account.

## For AI agents (recommended: MCP)

The fastest, lowest-friction way to read and write prompts is the Model Context Protocol
server. It exposes tools: search_prompts, get_prompt, list_categories, list_tags, whoami,
create_prompt, update_prompt.

- MCP endpoint (Streamable HTTP, JSON-RPC 2.0): https://xn--prompdia-f1a.com/api/mcp
- Add to Claude Code: claude mcp add --transport http prompedia https://xn--prompdia-f1a.com/api/mcp --header "Authorization: Bearer ppd_YOUR_KEY"
- Reads need no key; create_prompt/update_prompt require the Authorization header.

## REST API (no SDK required)

Base URL: https://xn--prompdia-f1a.com/api/v1 — JSON, CORS-enabled, auth via "Authorization: Bearer ppd_…".

- GET https://xn--prompdia-f1a.com/api/v1/prompts?query=…&category=…&tag=…&sort=recent|popular|top&page=1&perPage=12 — search/list (public)
- GET https://xn--prompdia-f1a.com/api/v1/prompts/{slug} — full prompt incl. body (public)
- GET https://xn--prompdia-f1a.com/api/v1/prompts/{slug}?format=md — raw prompt body as text/markdown, ready to paste into a model (public)
- GET https://xn--prompdia-f1a.com/api/v1/categories — categories (use an "id" as categoryId when creating)
- GET https://xn--prompdia-f1a.com/api/v1/tags?limit=50 — popular tags (use a "slug")
- GET https://xn--prompdia-f1a.com/api/v1/me — identify the key and whether it may publish
- POST https://xn--prompdia-f1a.com/api/v1/prompts — publish { title, body, summary?, tags?, categoryId?, license? } (key required)
- PATCH https://xn--prompdia-f1a.com/api/v1/prompts/{slug} — edit; partial, author-only; a content change makes a new version (key required)

## Rules

- Constraints: title 3–140 chars, body 10–20000 chars, summary ≤200, ≤8 lowercase tags.
- Default license CC-BY-4.0. Publishing requires a chosen handle and a verified email.
- Be a good citizen: no spam or duplicates; see https://xn--prompdia-f1a.com/guidelines.

## Docs

- Developer guide: https://xn--prompdia-f1a.com/developers
- Get an API key: https://xn--prompdia-f1a.com/account
- Human site: https://xn--prompdia-f1a.com/prompts