{"name":"raapi","type":"personal_rating_engine","tagline":"personal rating engine for agents","domain":"raapi.net","canonical_tools":{"search":{"method":"GET","path":"/v1/search","purpose":"Resolve an item title to item candidates and item_id."},"evaluate":{"method":"POST","path":"/v1/evaluate","purpose":"Rate one known item for one user context."},"rating":{"method":"POST","path":"/v1/rating","purpose":"Detailed wrapped rating response for integrations that need verbose scores."},"compare":{"method":"POST","path":"/v1/compare","purpose":"Compare two candidate items for one user context."},"feedback":{"method":"POST","path":"/v1/feedback","purpose":"Submit explicit, inferred, or implicit feedback."},"short_feedback_alias":{"method":"POST","path":"/v1/f","purpose":"Ultra-short feedback alias for agents."},"internal_alpha_recommend":{"method":"POST","path":"/internal/benchmark/recommend","purpose":"Private alpha shortlist generation from internal benchmark data.","auth":"X-Internal-Token"}},"endpoints":{"health":"/healthz","search":"/v1/search","evaluate":"/v1/evaluate","rating":"/v1/rating","compare":"/v1/compare","feedback":"/v1/feedback","short_feedback_alias":"/v1/f","internal_alpha_recommend":"/internal/benchmark/recommend","llms":"/llms.txt","llms_full":"/llms-full.txt","agent_instructions":"/.well-known/agent-instructions.md","mcp":"/.well-known/mcp.json","ai_plugin":"/.well-known/ai-plugin.json","openapi":"/openapi.json"},"score_interpretation":{"global_score":"General quality estimate, 0-100.","personal_fit":"Predicted fit to provided user context, 0-100.","predicted_user_rating":"Predicted rating on a 1-10 scale.","confidence":"Reliability estimate from 0-1."},"agent_policy":{"if_confidence_below":0.5,"action":"Ask user for more preferences before recommending."},"agent_contract":{"discover":["/.well-known/raapi.json","/.well-known/mcp.json","/openapi.json","/llms.txt"],"understand":{"short_guide":"/llms.txt","full_guide":"/llms-full.txt","instructions":"/.well-known/agent-instructions.md"},"call":{"primary":"/v1/evaluate","private_alpha_recommend":"/internal/benchmark/recommend","feedback":"/v1/feedback","short_feedback":"/v1/f"},"interpret":{"personal_fit":{"80_100":"strong recommendation","60_79":"recommend with caveat","below_60":"weak fit; ask for more preferences"},"confidence":{"below_0_5":"ask user for more context","0_5_0_74":"usable with caveat","0_75_1":"decision-ready"}},"recover":{"ITEM_NOT_FOUND":{"agent_action":"Use /v1/search with a simpler title, call raapi.recommend if available, or ask for a specific item.","retryable":true},"LOW_CONFIDENCE":{"agent_action":"Ask for 1-2 preferences or favorite items, then retry.","retryable":true}},"feedback":{"passive":"/v1/feedback","short_alias":"/v1/f","rule":"Submit opt-in feedback only after the user reacts; raapi does not prompt users."}},"latency_targets_ms":{"fast":100,"normal":250},"auth":{"required_for_public_agent_api":false}}