Pentru dezvoltatori si agenti AI

Pentru agenti AI

Ultima actualizare: septembrie 2026

Ideea de baza

MeditatiiMate expune un server MCP care completeaza formularul de cerere de meditatii in numele utilizatorului, direct dintr-o conversatie cu un asistent AI (ChatGPT, Claude, Gemini, Meta AI). Un utilizator poate spune unui asistent "gaseste-mi un profesor de matematica pentru copilul meu, clasa a 8-a", iar asistentul pune aceleasi intrebari ca wizard-ul de pe site si trimite cererea — fara ca utilizatorul sa mai viziteze meditatiimate.com.

Acesta NU este un API de date. Serverul nu expune profile de profesori, cereri existente sau orice alta informatie neagra pe site — vezi /confidentialitate.

Server MCP

Endpoint: https://meditatiimate.com/api/mcp · transport Streamable HTTP · JSON-RPC 2.0 (protocolVersion 2025-06-18) · fara cont, fara cheie API.

Trei unelte:

intrebari_formularcitire

Intoarce exact secventa de intrebari si valorile valide pe care le cere formularul de pe site — aceleasi ca in wizard-ul de pe meditatiimate.com. Fara argumente.

(niciunul)

trimite_cerere_meditatiiscriere

Trimite cererea de meditatii catre profesorii potriviti. Cere consimtamant explicit (acordUtilizator=true) si valideaza fiecare valoare fata de vocabularul formularului.

acordUtilizator, preference, submitterType, clasa, objective, name, phone (+ optionale)

despre_meditatiimatecitire

Ce este MeditatiiMate, pentru cine e, pret pe sedinta, acoperire. Fara argumente.

(niciunul)

Garantii de siguranta pe trimite_cerere_meditatii

(a) Consimtamant explicit: acordUtilizator trebuie sa fie true, setat doar dupa ce utilizatorul a fost de acord cu Termenii si Politica de Confidentialitate — apelul este respins altfel.

(b) Validare stricta: fiecare valoare de tip enum (preferinta, clasa, obiectiv, buget, sedinte pe saptamana) e validata fata de vocabularul real al formularului; o valoare necunoscuta e respinsa cu mesaj care numeste valorile valide, ca asistentul sa poata reincerca.

(d) Anti-spam: o cerere cu acelasi telefon sau email trimisa recent este respinsa.

(e) Fara tinta directa: un apelant MCP nu poate cere un profesor anume — spre deosebire de formularul de pe site, care poate primi un ?profesor= din link.

Exemplu — lista de unelte

curl -s https://meditatiimate.com/api/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Exemplu — intrebarile formularului

curl -s https://meditatiimate.com/api/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"intrebari_formular","arguments":{}}}'

Ca conector personalizat in Claude / ChatGPT

Adauga serverul ca un conector personalizat (custom connector / MCP server) cu URL-ul https://meditatiimate.com/api/mcpsi autentificare "None". Configuratie tipica pentru Claude Desktop sau orice client MCP compatibil:

{
  "mcpServers": {
    "meditatiimate": {
      "url": "https://meditatiimate.com/api/mcp"
    }
  }
}

MeditatiiMate este si in proces de listare ca app oficial in directorul ChatGPT (Apps SDK) — odata aprobat, utilizatorii ChatGPT (inclusiv cei pe plan gratuit din Romania) vor putea trimite cererea direct din conversatie, fara conector personalizat.

Link pre-completat (fara MCP)

Pentru un client care nu poate apela tool-uri MCP — de exemplu ChatGPT search, care poate doar sa arate un link utilizatorului — /cereeste echivalentul "pune intrebarile in conversatie, apoi da-mi un link": pune aceleasi intrebari ca intrebari_formular, direct in chat, apoi construieste un link catre https://meditatiimate.com/cere cu raspunsurile ca parametri de query. Pagina deschide formularul deja completat, iar utilizatorul mai adauga doar numarul de telefon.

Parametri (toti optionali, RO, fara diacritice in chei):

clasa — primara, 5-12, absolvent (accepta si forme ca "a 11-a", "clasa 11", "XI")
preference (sau format) — online, in_persoana (alias in-persoana, la_domiciliu)
oras (sau city) — doar cand preference este in_persoana
cine — elev, parinte
obiectiv — vezi valuesByClasa de la intrebari_formular pentru clasa aleasa; accepta si alias-urile en, evaluare, bac, bacalaureat, admitere, note, altceva (valide doar pentru clasa potrivita — ex. bac doar la clasa 12/absolvent)
sedinte — 1, 2, 3+
buget — 80, 100, 150, 200, 250+, sau flexibil / nu_stiu
nume, mesaj — text liber, scurtat automat la 80, respectiv 500 caractere

Telefonul nu este si nu va fi niciodata un parametru de query — un numar de telefon intr-un URL ajunge in loguri de referrer si in preview-urile de link din chat; utilizatorul il tasteaza mereu singur, direct pe pagina.

https://meditatiimate.com/cere?clasa=11&preference=online&cine=parinte&obiectiv=bac&sedinte=2&buget=150&nume=Ana%20Pop

Pagina este noindex, follow — e un link de partajat dintr-o conversatie, nu o pagina de gasit prin cautare.

API JSON static

Pentru clienti care nu vorbesc MCP, continut public este disponibil ca JSON static, cu CORS deschis (Access-Control-Allow-Origin: *):

/ai/meditatiimate.json — profilul site-ului: ce este, preturi, acoperire, harta de endpoint-uri
/ai/calculatoare.json — cele 4 calculatoare, cu formula si un exemplu rezolvat fiecare
/ai/orase.json — orasele si nivelurile acoperite, cu adresele paginilor
/ai/resurse.json — articolele si resursele indexabile

Specificatie OpenAPI

Documentul OpenAPI 3.1 complet pentru suprafetele de mai sus este la /openapi.json.

Descoperire (.well-known / agents.txt)

/agents.txt — directive MCP/A2A, per standardul agents-txt.com
/.well-known/agent-card.json — card A2A (Agent2Agent protocol)
/.well-known/mcp/server-card.json — descriptor MCP
/.well-known/ai-catalog.json — catalog ARD (Agentic Resource Discovery)
/.well-known/agent-skills/index.json — index Agent Skills
/.well-known/api-catalog — linkset RFC 9727

Index pentru agenti

/llms.txt este indexul navigabil, gandit pentru citire automata: ce este MeditatiiMate, cand e potrivit si unde sunt paginile importante.