Health Intelligence for AI Agents

What is B.O.N.S.A.I.?

Biologically-driven, Observationally-validated, Nutritionally-tested, Safe, Accessible, Integrative — a health intelligence framework grounded in whole-food plant-based (WFPB) lifestyle medicine and the ACLM Six Pillars.

This API lets your AI agent query our knowledge base, generate condition-specific food-as-medicine protocols, interpret lab results with pattern recognition, and run full six-pillar lifestyle assessments. Every response is backed by clinical evidence from the AHA, ADA, WHO, and peer-reviewed literature.

Conditions Covered

Lab Panels Supported

Pricing

Pay per call via the x402 protocol using USDC on Base (Coinbase L2). No API keys, no monthly billing. Your agent sends a payment header with each request and gets the response instantly.

How It Works

API Reference

Base URL: https://api.bons.ai/v1

# Query the knowledge base
curl "https://api.bons.ai/v1/query?q=best+foods+for+lowering+blood+pressure&pillar=nutrition&limit=3" \
  -H "X-402-Payment: <x402_payment_header>"

# Generate a hypertension protocol
curl -X POST "https://api.bons.ai/v1/protocol" \
  -H "Content-Type: application/json" \
  -H "X-402-Payment: <x402_payment_header>" \
  -d '{
    "condition": "hypertension",
    "user_context": {
      "age": 52,
      "severity": "moderate"
    },
    "duration_weeks": 4
  }'

# Get a lab-informed protocol
curl -X POST "https://api.bons.ai/v1/lab-protocol" \
  -H "Content-Type: application/json" \
  -H "X-402-Payment: <x402_payment_header>" \
  -d '{
    "lab_values": {
      "fasting_glucose": "105 mg/dL",
      "HbA1c": "6.1%",
      "LDL": "142 mg/dL",
      "HDL": "38 mg/dL",
      "triglycerides": "188 mg/dL",
      "CRP": "3.2 mg/L"
    },
    "health_goals": ["reduce inflammation", "improve insulin sensitivity"],
    "condition": "type_2_diabetes"
  }'

# Run a full lifestyle assessment
curl -X POST "https://api.bons.ai/v1/assess" \
  -H "Content-Type: application/json" \
  -H "X-402-Payment: <x402_payment_header>" \
  -d '{
    "current_habits": {
      "diet_description": "Standard American diet, fast food 3x/week",
      "exercise_minutes_per_week": 60,
      "sleep_hours_per_night": 5.5,
      "stress_level": "high",
      "tobacco_use": false,
      "alcohol_drinks_per_week": 8,
      "social_connection_quality": "limited"
    },
    "health_goals": ["lose weight", "sleep better", "reduce stress"]
  }'

MCP Integration

B.O.N.S.A.I. is available as a Model Context Protocol (MCP) server, enabling native discovery by AI platforms like Claude, ChatGPT, and Gemini. Four tools are exposed:

Quick Start: Claude Desktop

Add this to your claude_desktop_config.json and restart Claude. Your Claude will instantly have access to all four B.O.N.S.A.I. tools.

// ~/Library/Application Support/Claude/claude_desktop_config.json  (macOS)
// %APPDATA%\Claude\claude_desktop_config.json                     (Windows)
{
  "mcpServers": {
    "bonsai-health": {
      "url": "https://web-production-ae61.up.railway.app"
    }
  }
}

Quick Start: Cursor

Add this to your .cursor/mcp.json in any project root — or globally at ~/.cursor/mcp.json.

{
  "mcpServers": {
    "bonsai-health": {
      "url": "https://web-production-ae61.up.railway.app"
    }
  }
}

Quick Start: Any MCP Client

Point any MCP-compatible client at the server URL. The tool manifest is auto-served at /.well-known/mcp.json.

# Server URL
https://web-production-ae61.up.railway.app

# MCP Registry ID
io.github.rabyavalla/bonsai-health

x402 Payment Protocol

All endpoints use the x402 protocol for payment. This means your agent pays per call using USDC on the Base network (Coinbase L2). No API keys, no OAuth, no billing accounts.

How x402 works

1. Your agent makes a request to any endpoint without payment
2. The API responds with 402 Payment Required and payment instructions
3. Your agent signs a USDC payment on Base and resends the request with the X-402-Payment header
4. The API verifies payment and returns the response

Scope & Limitations

B.O.N.S.A.I. provides evidence-based lifestyle medicine intelligence. It does not provide: