API & MCP — programmatic access

Give an AI assistant (or your scripts) frictionless access to read and publish prompts on Prompedia. Reading is open; writing requires a personal API key.

1. Get an API key

Create a key from your My account page. It's only shown once — copy it immediately. Publishing also requires a username and a verified email. Every write is attributed to your account.

2. Connect an AI agent via MCP (recommended)

The Model Context Protocol server exposes ready-to-use tools: search_prompts, get_prompt, list_categories, list_tags, whoami, create_prompt, update_prompt. Endpoint: https://xn--prompdia-f1a.com/api/mcp

With Claude Code:

claude mcp add --transport http prompedia https://xn--prompdia-f1a.com/api/mcp \
  --header "Authorization: Bearer ppd_TA_CLE"

For Claude Desktop / another compatible client, add a remote HTTP server pointing to the same URL with the same Authorization header. Without a key, read-only tools still work.

3. Or use the REST API

JSON, CORS enabled, authentication via Authorization: Bearer ppd_… header. Base: https://xn--prompdia-f1a.com/api/v1

GET/api/v1/prompts?query=&sort=recent&page=1Search/list — public

GET/api/v1/prompts/{slug}Full prompt (body included) — public

GET/api/v1/prompts/{slug}?format=mdRaw Markdown body, ready to paste — public

GET/api/v1/categoriesCategories (id → categoryId) — public

GET/api/v1/tags?limit=50Popular tags (slug) — public

GET/api/v1/meKey identity + publish rights — key required

POST/api/v1/promptsPublish a prompt — key required

PATCH/api/v1/prompts/{slug}Edit (partial, author) — key required

Examples:

# Search
curl "https://xn--prompdia-f1a.com/api/v1/prompts?query=traduction&sort=top"

# Read a prompt body, ready to paste into a model
curl "https://xn--prompdia-f1a.com/api/v1/prompts/mon-prompt?format=md"

# Publish (key required)
curl -X POST "https://xn--prompdia-f1a.com/api/v1/prompts" \
  -H "Authorization: Bearer ppd_TA_CLE" \
  -H "Content-Type: application/json" \
  -d '{"title":"Résumé d'''article","body":"Tu es un assistant qui résume…","tags":["resume","ecriture"]}'

Constraints & best practices

Title 3–140 chars · body 10–20,000 · summary ≤200 · up to 8 lowercase tags.
Default license: CC-BY-4.0. Publishing requires a username and a verified email.
Rate limits: reads are generous; publishing ~5/h, edits ~20/h (per account).
No spam or duplicates — follow the contribution guidelines.
Machine-readable overview: /llms.txt