4 Working Examples

Examples

Complete, runnable AIP implementations covering different industries and use cases. Each includes a manifest, server, and README.

Pick Your Use Case

Every example is a standalone Node.js server you can run locally. No dependencies beyond Node itself.

Health Assessment

Metabolic health intake for men 40+. Anonymized health markers in, personalized plan recommendations out.

Binding health/assessment

Jump to example ↓

🔧

Service Matching

Service marketplace that matches users with vetted local providers based on service type, location, and budget.

Binding service/matching

Jump to example ↓

💻

SaaS Onboarding

Pre-configured trial workspace setup based on team size, use case, and integration needs.

Binding saas/onboarding

Jump to example ↓

🧮

BMI Calculator

Stateless health calculator. No binding, no account — submit numbers, get results.

Non-binding tool/calculator

Jump to example ↓

Running the Examples

Clone the repo and start any example in seconds.

git clone https://github.com/agent-intake-protocol/agent-intake-protocol.git
cd agent-intake-protocol/examples/health-assessment
node server.js

Each server exposes two endpoints:

Test with curl:

# Discover
curl http://localhost:3000/.well-known/agent-intake.json

# Submit intake
curl -X POST http://localhost:3000/api/aip/metabolic-assessment \
  -H "Content-Type: application/json" \
  -d '{
    "aip_version": "0.1.0",
    "session_id": "test-001",
    "intake_id": "metabolic-assessment",
    "intake_data": {
      "age_range": "40-49",
      "sex": "male",
      "primary_concern": "insulin_resistance",
      "fasting_glucose_range": "elevated",
      "activity_level": "sedentary",
      "bmi_range": "overweight"
    }
  }'

❤ Health Assessment

A metabolic health platform for men 40+. The agent submits anonymized health markers (age range, glucose range, BMI category) and receives a personalized optimization plan.

Manifest

Key design choices: all inputs use ranges/categories instead of exact values, no PII required, and the privacy block explicitly declares data_retention: "none".

{
  "aip_version": "0.1.0",
  "provider": {
    "name": "Man vs Health",
    "url": "https://manvshealth.com",
    "description": "Men's metabolic health optimization platform"
  },
  "intakes": [{
    "id": "metabolic-assessment",
    "name": "Metabolic Health Assessment",
    "description": "Submit basic metabolic markers for a personalized plan",
    "endpoint": "https://manvshealth.com/api/aip/metabolic-assessment",
    "method": "POST",
    "category": "health/assessment",
    "input_schema": {
      "type": "object",
      "required": ["age_range", "sex", "primary_concern"],
      "properties": {
        "age_range": { "type": "string", "enum": ["30-39", "40-49", "50-59", "60+"] },
        "sex": { "type": "string", "enum": ["male", "female"] },
        "primary_concern": { "type": "string", "enum": ["weight", "energy", "insulin_resistance", "general"] },
        "fasting_glucose_range": { "type": "string", "enum": ["normal", "elevated", "high", "unknown"] },
        "activity_level": { "type": "string", "enum": ["sedentary", "light", "moderate", "active"] },
        "bmi_range": { "type": "string", "enum": ["normal", "overweight", "obese", "unknown"] }
      }
    },
    "offer_type": "personalized_recommendation",
    "binding_available": true,
    "requires_auth": false,
    "privacy": { "data_retention": "none", "pii_required": false, "redacted_acceptable": true }
  }]
}

Response

The server analyzes the intake data and returns a structured offer with a personalized plan, risk assessment, and recommended actions. If the user wants to proceed, they bind with their email and name.

{
  "aip_version": "0.1.0",
  "session_id": "test-001",
  "status": "offer",
  "offer": {
    "id": "offer-abc123",
    "summary": "Based on your profile, we recommend our Metabolic Reset program.",
    "details": {
      "plan": "Metabolic Reset — 12 Week Program",
      "focus_areas": ["insulin sensitivity", "body composition", "energy optimization"],
      "risk_level": "moderate",
      "estimated_duration": "12 weeks",
      "price": 197,
      "currency": "USD"
    },
    "expires": "2026-03-06T12:00:00Z",
    "bind_endpoint": "https://manvshealth.com/api/aip/bind",
    "bind_requires": ["email", "full_name"]
  }
}

View full source on GitHub →

🔧 Service Matching

A marketplace that connects users with vetted local service providers. The agent submits a service request with type, zip code, and budget range — and gets back matched providers ranked by fit.

Manifest Highlights

Response

Returns 1-3 matched providers with ratings, availability, and estimated price ranges. The user reviews matches before binding to share contact info with their chosen provider.

{
  "status": "offer",
  "offer": {
    "summary": "We found 3 plumbers in your area.",
    "details": {
      "matches": [
        {
          "provider": "Johnson Plumbing",
          "rating": 4.8,
          "reviews": 142,
          "available": "this_week",
          "estimate": "$150–$300"
        }
      ],
      "total_matches": 3
    },
    "bind_requires": ["full_name", "phone", "address"]
  }
}

View full source on GitHub →

💻 SaaS Onboarding

A project management tool that pre-configures trial workspaces based on team profile. The agent submits team size, use case, current tools, and needed integrations — and gets back a ready-to-go trial offer.

Manifest Highlights

Response

Returns a pre-configured workspace offer with selected plan, enabled integrations, migration path from current tools, and a direct setup URL at bind time.

{
  "status": "offer",
  "offer": {
    "summary": "Your 14-day trial workspace is ready to configure.",
    "details": {
      "plan": "Team",
      "seats": 15,
      "features_enabled": ["kanban", "gantt", "time_tracking", "automations"],
      "integrations": ["slack", "github"],
      "migration_from": "jira",
      "trial_days": 14
    },
    "bind_requires": ["email", "company_name"]
  }
}

View full source on GitHub →

🧮 BMI Calculator

The simplest possible AIP implementation — a stateless calculator. No binding, no account, no PII. Submit height and weight, get a BMI result. Demonstrates that AIP handles non-binding, utility-style interactions too.

Manifest Highlights

Response

{
  "status": "complete",
  "offer": {
    "summary": "Your BMI is 27.5 (Overweight).",
    "details": {
      "bmi": 27.5,
      "category": "Overweight",
      "healthy_range": "18.5–24.9",
      "note": "BMI is a screening tool, not a diagnostic measure."
    },
    "expires": null,
    "bind_endpoint": null
  }
}

View full source on GitHub →

Build Your Own

These examples are starting points. AIP works for any business with an intake process — legal, financial, education, real estate, you name it.

Read the Spec Fork on GitHub