API e MCP per sviluppatori

Remember to Roar offre un'API REST pubblica e un server MCP, entrambi in sola lettura, per leggere informazioni sul sito, le pagine in markdown e gli articoli pubblicati dalla community del blog.

Autenticazione

Nessuna. Tutti gli endpoint sono pubblici e accettano solo GET (l'API) o POST JSON-RPC (il server MCP). Non esistono operazioni di scrittura.

Endpoint REST

Base URL: https://remembertoroar.com. Contratto completo in OpenAPI 3.1, catalogo in /.well-known/api-catalog.

Metodo e path	Restituisce
`GET /api/v1/info`	Autore, contatti, argomenti e link alle risorse
`GET /api/v1/pages`	Pagine pubbliche con titolo e descrizione
`GET /api/v1/posts?limit=20`	Articoli pubblicati, dal più recente (limit 1-50)
`GET /api/v1/posts/{slug}`	Articolo completo

Esempi con curl

curl -s https://remembertoroar.com/api/v1/info
curl -s "https://remembertoroar.com/api/v1/posts?limit=5"
curl -s https://remembertoroar.com/api/v1/posts/SLUG

# Qualsiasi pagina del sito in markdown
curl -s -H "Accept: text/markdown" https://remembertoroar.com/chi-sono/

Limiti di richieste

60 richieste in 60 secondi per indirizzo IP. Ogni risposta dell'API porta gli header IETF RateLimit-Policy: "default";q=60;w=60 e RateLimit: "default";r=<rimaste>;t=<secondi al reset>. Oltre il limite la risposta è 429 con Retry-After.

Errori

Gli errori sotto /api/ usano application/problem+json (RFC 9457) con i campi type, title, status, detail, code e resolution.

{
  "type": "https://remembertoroar.com/docs/#errors",
  "title": "Not Found",
  "status": 404,
  "detail": "Nessun articolo pubblicato con slug \"esempio\".",
  "code": "post_not_found",
  "resolution": "Elenca gli articoli con GET /api/v1/posts."
}

code	status	Significato
`not_found`	404	Endpoint inesistente
`post_not_found`	404	Slug senza articolo pubblicato
`invalid_limit`	400	Parametro limit non valido
`invalid_slug`	400	Slug non valido
`method_not_allowed`	405	Metodo diverso da GET
`rate_limited`	429	Limite superato
`upstream_unavailable`	502	Database degli articoli non raggiungibile
`internal_error`	500	Errore imprevisto

Server MCP

Endpoint Streamable HTTP: https://remembertoroar.com/mcp (JSON-RPC 2.0 via POST, risposte JSON, nessuna sessione). Manifest: server card e server.json.

get_site_info — informazioni sul sito
list_pages — elenco pagine
get_page_markdown — pagina in markdown (argomento path)
list_blog_posts — articoli del blog (argomento limit)
get_blog_post — articolo del blog (argomento slug)

Risorse: https://remembertoroar.com/api/v1/info (Informazioni sul sito), https://remembertoroar.com/llms.txt (llms.txt), https://remembertoroar.com/ (Home in markdown).

curl -s https://remembertoroar.com/mcp \
  -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Per un client MCP: {"mcpServers":{"remember-to-roar":{"url":"https://remembertoroar.com/mcp"}}}

Contatti

Domande o problemi con l'API: [email protected] oppure la pagina Contatti. Indice per agenti AI: llms.txt.