SDK Overview

BondMCP provides official SDKs in multiple languages to help you integrate with our API quickly and easily. These SDKs handle authentication, error handling, rate limiting, and provide a clean interface to all BondMCP endpoints.

Available SDKs

Python SDK

pip install bondmcp

from bondmcp import BondMCPClient

# Initialize client with your API key
client = BondMCPClient(api_key="your_api_key")

# Ask a health question
response = client.ask("What are the best supplements for joint health?")
print(response.answer)

# Interpret lab results
lab_results = [
    {"name": "Vitamin D", "value": 25, "unit": "ng/mL", "reference_range": "30-100"},
    {"name": "Ferritin", "value": 15, "unit": "ng/mL", "reference_range": "20-200"}
]
interpretation = client.labs.interpret(lab_results)
print(interpretation.insights)

# Get supplement recommendations
recommendations = client.supplement.recommend(health_goals=["joint health", "energy"])
print(recommendations.supplements)

JavaScript/TypeScript SDK

npm install bondmcp
# or
yarn add bondmcp

import { BondMCPClient } from 'bondmcp';

// Initialize client with your API key
const client = new BondMCPClient({ apiKey: 'your_api_key' });

// Ask a health question
const response = await client.ask('What are the best supplements for joint health?');
console.log(response.answer);

// Interpret lab results
const labResults = [
  { name: 'Vitamin D', value: 25, unit: 'ng/mL', referenceRange: '30-100' },
  { name: 'Ferritin', value: 15, unit: 'ng/mL', referenceRange: '20-200' }
];
const interpretation = await client.labs.interpret(labResults);
console.log(interpretation.insights);

// Get supplement recommendations
const recommendations = await client.supplement.recommend({
  healthGoals: ['joint health', 'energy']
});
console.log(recommendations.supplements);

Go SDK

go get github.com/bondmcp/bondmcp-go

package main

import (
    "fmt"
    "github.com/bondmcp/bondmcp-go"
)

func main() {
    // Initialize client with your API key
    client := bondmcp.NewClient("your_api_key")

    // Ask a health question
    response, err := client.Ask("What are the best supplements for joint health?")
    if err != nil {
        panic(err)
    }
    fmt.Println(response.Answer)

    // Interpret lab results
    labResults := []bondmcp.LabResult{
        {Name: "Vitamin D", Value: 25, Unit: "ng/mL", ReferenceRange: "30-100"},
        {Name: "Ferritin", Value: 15, Unit: "ng/mL", ReferenceRange: "20-200"},
    }
    interpretation, err := client.Labs.Interpret(labResults)
    if err != nil {
        panic(err)
    }
    fmt.Println(interpretation.Insights)

    // Get supplement recommendations
    recommendations, err := client.Supplement.Recommend([]string{"joint health", "energy"})
    if err != nil {
        panic(err)
    }
    fmt.Println(recommendations.Supplements)
}

Error Handling

All SDKs provide consistent error handling patterns. Errors are categorized into:

• Authentication errors: Issues with your API key

• Validation errors: Problems with your request parameters

• Rate limit errors: You've exceeded your usage limits

• Server errors: Issues on our end

Each SDK follows the idiomatic error handling pattern for its language.

Python Example

from bondmcp import BondMCPClient, BondMCPAPIError, BondMCPNetworkError

client = BondMCPClient(api_key="your_api_key")

try:
    client.ask("What are the symptoms of high blood pressure?")
except BondMCPAPIError as e:
    print(f"API error {e.status_code} ({e.code}): {e}")
except BondMCPNetworkError as e:
    print(f"Network error: {e}")

Sample output when the API key is invalid:

API error 401 (authentication_error): Invalid API key

Sample output for a network issue:

Network error: Connection timed out

JavaScript Example

import { BondMCPClient, BondMCPAPIError, BondMCPNetworkError } from 'bondmcp';

const client = new BondMCPClient({ apiKey: 'your_api_key' });

try {
  await client.ask('What are the symptoms of high blood pressure?');
} catch (error) {
  if (error instanceof BondMCPAPIError) {
    console.log(`API error ${error.statusCode} (${error.code}): ${error.message}`);
  } else if (error instanceof BondMCPNetworkError) {
    console.log('Network error:', error.message);
  } else {
    console.log('Unexpected error:', error);
  }
}

Sample output for a missing endpoint:

API error 404 (not_found): Endpoint not found

Pagination

For endpoints that return large collections of data, our SDKs provide pagination helpers:

# Python example
all_results = []
for page in client.health_data.list_all():
    all_results.extend(page.results)

// JavaScript example
const allResults = [];
for await (const page of client.healthData.listAll()) {
    allResults.push(...page.results);
}

Advanced Configuration

All SDKs support additional configuration options:

• Custom base URL

• Request timeouts

• Retry policies

• Custom HTTP clients

Refer to each SDK's documentation for language-specific configuration details.

SDK Source Code

All our SDKs are open source and available in the BondMCP/mcp repository. We welcome contributions and feedback to improve our developer experience.