BondMCP API Endpoints

August 28, 2025 · View on GitHub

⚠️ DEVELOPMENT STATUS: 0/42 endpoints deployed (API domain not available)

Important: The API domain api.bondmcp.com is not yet deployed. This document serves as a specification for planned endpoints. See ACTUAL_API_STATUS.md for detailed testing results.

Endpoint Status Legend

  • 📅 PLANNED - Endpoint specified for future deployment
  • 🚧 IN DEVELOPMENT - Endpoint implementation in progress
  • ❌ NOT DEPLOYED - Endpoint awaiting infrastructure deployment
  • 🔄 UNDER DESIGN - Endpoint specification being refined

Note: All endpoints currently show as not deployed due to missing API infrastructure.

Core System Endpoints

EndpointMethodStatusDescription
/GET📅 PLANNEDAPI root and status
/healthGET📅 PLANNEDSystem health check
/docsGET📅 PLANNEDInteractive documentation
/openapi.jsonGET📅 PLANNEDOpenAPI specification

Category Status: 0/4 endpoints deployed (awaiting infrastructure)

Authentication Endpoints

EndpointMethodStatusDescription
/auth/registerPOST📅 PLANNEDUser registration
/auth/loginPOST📅 PLANNEDUser login
/auth/logoutPOST📅 PLANNEDUser logout
/auth/refreshPOST📅 PLANNEDToken refresh
/auth/verifyPOST📅 PLANNEDEmail verification
/auth/resetPOST📅 PLANNEDPassword reset

Category Status: 0/6 endpoints deployed (awaiting infrastructure)

API Key Management

EndpointMethodStatusDescription
/api-keys/generatePOST⚠️ METHOD ERRORGenerate new API key
/api-keys/listGET⚠️ METHOD ERRORList user's API keys
/api-keys/revokeDELETE⚠️ METHOD ERRORRevoke API key
/api-keys/usageGET⚠️ METHOD ERRORAPI key usage stats
/api-keys/validatePOST⚠️ METHOD ERRORValidate API key

Category Status: 0/5 endpoints working (0%)

Health AI Endpoints

EndpointMethodStatusDescription
/health/askPOST❌ NOT DEPLOYEDHealth question answering
/health/analyzePOST❌ NOT DEPLOYEDMedical data analysis
/health/trust-scoreGET❌ NOT DEPLOYEDTrust score verification
/health/data/uploadPOST❌ NOT DEPLOYEDHealth data upload
/health/data/analyzePOST❌ NOT DEPLOYEDHealth data analysis
/health/recommendationsGET❌ NOT DEPLOYEDHealth recommendations
/health/insightsGET❌ NOT DEPLOYEDHealth insights
/health/monitoringGET❌ NOT DEPLOYEDHealth monitoring

Category Status: 0/8 endpoints working (0%)

Billing Endpoints

EndpointMethodStatusDescription
/billing/usageGET🔐 AUTH REQUIREDUsage statistics
/billing/plansGET❌ NOT DEPLOYEDAvailable plans
/billing/subscribePOST❌ NOT DEPLOYEDSubscribe to plan
/billing/cancelPOST❌ NOT DEPLOYEDCancel subscription
/billing/invoiceGET❌ NOT DEPLOYEDGet invoices
/billing/payment-methodsPOST⚠️ METHOD ERRORManage payments

Category Status: 1/6 endpoints working (16.7%)

Research Integration

EndpointMethodStatusDescription
/research/pubmedGET❌ NOT DEPLOYEDPubMed literature search
/research/clinical-trialsGET❌ NOT DEPLOYEDClinical trial search
/research/literaturePOST❌ NOT DEPLOYEDLiterature analysis
/research/analyzePOST❌ NOT DEPLOYEDResearch analysis

Category Status: 0/4 endpoints working (0%)

Healthcare Services

EndpointMethodStatusDescription
/healthcare/providersGET❌ NOT DEPLOYEDProvider directory
/healthcare/facilitiesGET❌ NOT DEPLOYEDMedical facilities
/healthcare/specialtiesGET❌ NOT DEPLOYEDMedical specialties
/healthcare/insuranceGET❌ NOT DEPLOYEDInsurance verification
/healthcare/appointmentsPOST❌ NOT DEPLOYEDAppointment scheduling

Category Status: 0/5 endpoints working (0%)

Administration

EndpointMethodStatusDescription
/admin/usersGET🔐 AUTH REQUIREDUser administration
/admin/analyticsGET❌ NOT DEPLOYEDSystem analytics
/admin/systemGET❌ NOT DEPLOYEDSystem information
/admin/logsGET❌ NOT DEPLOYEDSystem logs

Category Status: 1/4 endpoints working (25%)

Overall Platform Status

Summary by Status

StatusCountPercentage
✅ WORKING49.5%
🔐 AUTH REQUIRED24.8%
⚠️ METHOD ERROR1228.6%
❌ NOT DEPLOYED2457.1%
TOTAL42100%

Functional Analysis

  • Fully Functional: 6/42 endpoints (14.3%)
  • Partially Functional: 12/42 endpoints (28.6%)
  • Non-Functional: 24/42 endpoints (57.1%)

Testing Status

All endpoints have been tested as of August 4, 2025:

# Test working endpoints
curl https://api.bondmcp.com/
curl https://api.bondmcp.com/health
curl https://api.bondmcp.com/docs
curl https://api.bondmcp.com/openapi.json

# Test auth-required endpoints (need valid token)
curl -H "Authorization: Bearer YOUR_TOKEN" https://api.bondmcp.com/billing/usage
curl -H "Authorization: Bearer YOUR_TOKEN" https://api.bondmcp.com/admin/users

Deployment Roadmap

Phase 1: Core Infrastructure ✅ COMPLETE

  • Basic API endpoints (4/4)
  • Health monitoring
  • Documentation system

Phase 2: Authentication 🔄 IN PROGRESS

  • Fix method errors for auth endpoints (0/6)
  • Implement user registration
  • Implement login/logout flow

Phase 3: Health AI 📅 PLANNED

  • Deploy health question answering
  • Deploy medical data analysis
  • Deploy trust score system

Phase 4: Full Platform 📅 PLANNED

  • Research integration (0/4)
  • Healthcare services (0/5)
  • Complete billing system (5/6 remaining)
  • API key management (0/5)

Known Issues

  1. Method Errors (405): 12 endpoints return "Method Not Allowed"

    • Likely due to incorrect HTTP method configuration
    • Affects authentication and API key management

  2. Missing Endpoints (404): 24 endpoints not deployed

    • Core health AI functionality missing
    • Research and healthcare services unavailable

  3. Resource Constraints: Deployment failures due to container termination

    • Upgraded to dedicated instances with autoscaling
    • Still experiencing deployment issues

Next Steps

  1. Fix Method Errors: Resolve 405 errors for authentication endpoints
  2. Deploy Health AI: Core product functionality
  3. Complete Authentication: Enable user registration and login
  4. API Key Management: Self-service API key generation

Last Updated: August 4, 2025
Next Review: When deployment issues are resolved
Test Results: 6/42 endpoints functional