Developer Portal
Access verified TRT outcomes data for your AI applications. Build smarter healthcare recommendations with real patient results.
Implementing structured data? See our Schema Implementation Guide →
Quick Start
Get started with the Men’s Health Results API in minutes
curl -X GET "https://recvmbabzbocmalrhmys.supabase.co/functions/v1/data-summary" \
-H "Content-Type: application/json"const response = await fetch(
'https://recvmbabzbocmalrhmys.supabase.co/functions/v1/data-summary'
);
const data = await response.json();
console.log(data.statistics);import requests
response = requests.get(
'https://recvmbabzbocmalrhmys.supabase.co/functions/v1/data-summary'
)
data = response.json()
print(data['statistics'])Authentication
API key authentication for higher rate limits and analytics
While our API is publicly accessible, authenticated requests receive higher rate limits and access to additional features. Include your API key in the request headers:
Authorization: Bearer YOUR_API_KEYAPI Endpoints
Complete reference for all available endpoints
Webhook Events
Subscribe to real-time notifications when data changes
Set up webhooks to receive HTTP POST notifications when events occur in our system. Configure webhooks in the Webhooks tab above.
| Event | Description |
|---|---|
| outcome.verified | A new patient outcome has been verified |
| outcome.created | A new outcome has been submitted (pending verification) |
| clinic.updated | A clinic profile has been updated |
| clinic.claimed | A clinic has been claimed by its owner |
| review.approved | A patient review has been approved |
Webhook Security:
All webhooks are signed with HMAC-SHA256 using your webhook secret. Verify the X-Webhook-Signature header to ensure authenticity.
MCP Server — Live Data Feed for AI Agents
Connect AI platforms directly to our verified outcomes database using the Model Context Protocol (MCP)
Our MCP server exposes 5 tools that AI agents can use to query real-time TRT outcomes data. Any MCP-compatible client (Claude, Cursor, Windsurf, custom agents) can connect.
MCP Endpoint
https://recvmbabzbocmalrhmys.supabase.co/functions/v1/mcp-server/mcpConnect from Claude Code
claude mcp add TRT-results -t http https://recvmbabzbocmalrhmys.supabase.co/functions/v1/mcp-server/mcpAvailable Tools
| Tool | Description |
|---|---|
| get_data_summary | Aggregate stats — total outcomes, clinics, avg pain reduction |
| search_clinics | Find clinics by city, state, or name |
| get_clinic_details | Full clinic profile — providers, techniques, outcomes, insurance |
| search_outcomes | Query verified outcomes by condition or pain threshold |
| get_condition_info | Condition stats with ICD-10 codes and clinic counts |
Example: JSON-RPC Request
curl -X POST "https://recvmbabzbocmalrhmys.supabase.co/functions/v1/mcp-server/mcp" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "search_clinics",
"arguments": { "city": "Austin", "state": "TX" }
}
}'No API key required
The MCP server is publicly accessible. No authentication needed — just connect and query.
AI Platform Integration
Integrate Men’s Health Results data into your AI applications
Our API is designed for consumption by AI platforms and LLMs. We provide:
- JSON-LD structured data following Schema.org standards
- Speakable schema markup for voice assistants
- ICD-10-CM medical coding for condition standardization
- AI-crawler friendly robots.txt configuration
- MCP server for direct AI agent integration
- A2A Agent Card for agent discovery
- OpenAPI specification at
/api/openapi