📚 BondMCP Platform - Complete API Reference

BASE_URL="https://t9xbkyb7mg.us-east-1.awsapprunner.com"

# Register
curl -X POST ${BASE_URL}/auth/register \
  -H "Content-Type: application/json" \
  -d '{
    "email": "your-email@company.com",
    "password": "SecurePassword123!",
    "name": "Your Name"
  }'

# Response includes access_token
# Use this token in Authorization header for all requests

2. Generate API Key

# Using JWT token from registration
curl -X POST ${BASE_URL}/api/v1/api-keys/create \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "Production API Key"}'

3. Analyze Health Data

# Fitness analysis
curl -X POST ${BASE_URL}/health/fitness \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "activity": "running",
    "duration": 45,
    "intensity": "high"
  }'

# Returns AI-powered recommendations and calorie estimates

4. Check Subscription

curl -X GET ${BASE_URL}/billing/subscription \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

🔐 Authentication

Methods

Bearer Token (JWT) - Required for most endpoints

Authorization: Bearer eyJREDACTED_JWT_TOKEN

API Key - Alternative for programmatic access

X-API-Key: bcp_REDACTED_EXAMPLEyour_api_key_here

Token Lifecycle

Expiration: 24 hours
Refresh: Use /auth/refresh to get new token
Revocation: Use /auth/logout to blacklist token

📊 Subscription Tiers

Plan	Price	API Calls/Month	Features
Free	$0	100	Basic health endpoints, community support
Basic	$29	1,000	All health endpoints, email support
Premium	$99	10,000	Lab analysis, priority support, webhooks
Enterprise	$299	Unlimited	Custom integrations, 24/7 support, dedicated manager

🎯 Common Use Cases

Healthcare App Integration

# Example: LangGraph integration
from langchain_core.tools import tool
import requests

@tool
def analyze_patient_health(activity: str, duration: int) -> dict:
    """Analyze patient fitness using BondMCP"""
    response = requests.post(
        "https://t9xbkyb7mg.us-east-1.awsapprunner.com/health/fitness",
        headers={"Authorization": f"Bearer {token}"},
        json={"activity": activity, "duration": duration, "intensity": "moderate"}
    )
    return response.json()

Patient Dashboard

Register user → /auth/register
Get patient data → /api/v1/patients
View medical records → /api/v1/medical-records
Schedule appointment → /api/v1/appointments

AI Health Coach

Track vitals → /health/vitals
Analyze meals → /health/nutrition
Check symptoms → /health/symptoms
Get recommendations → AI analysis endpoints

🔗 Additional Resources

Interactive API Docs: https://t9xbkyb7mg.us-east-1.awsapprunner.com/docs
OpenAPI Specification: https://t9xbkyb7mg.us-east-1.awsapprunner.com/openapi.json
MCP Configuration: https://t9xbkyb7mg.us-east-1.awsapprunner.com/mcp/.well-known/mcp-configuration

⚠️ Known Limitations

Endpoint Duplication - Some endpoints exist in multiple versions (v1, v2, root). Use v1 versions when available.
Mock Data - Some endpoints (patients, appointments) return mock data for testing.
Consensus Mode - Multi-LLM consensus system deployed but not yet activated in endpoints.
Payment Methods - Adding cards requires Stripe.js frontend (cannot be done via API alone).

📞 Support

Documentation Issues: Open issue at github.com/bondmcp/docs
API Bugs: Open issue at github.com/auroracapital/bondmcp-platform
Email: info@auroracapital.nl

Last Updated: October 3, 2025
API Version: 2.1.0
Status: ✅ Production Ready