# Behavioral Science API

Commerce intelligence for AI agents. Apply behavioral science to products, funnels, copy, and pricing.

## Quick Start

**Base URL:** `https://phoslabs.io/api/v1`

### Get an API Key

New accounts get **100 free credits** to try any tool. Connect via MCP or use the REST API.

### Make Your First Call

```bash
curl -X POST https://phoslabs.io/api/v1/diagnose \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"funnel_description\": \"SaaS free trial to paid conversion, currently at 3%\"}"
```

## Tools

| Tool | What It Does | Credits |
|------|-------------|---------|
| `/audit` | Full behavioral audit of a product | 80 |
| `/diagnose` | Diagnose funnel dropoff | 10 |
| `/fix-checkout` | Redesign checkout with behavioral science | 30 |
| `/pricing` | Optimize pricing presentation | 15 |
| `/copy` | Behavioral rewrite of marketing copy | 12 |
| `/nudge` | Design behavioral nudges | 10 |
| `/biases` | Detect cognitive biases in UX | 10 |
| `/social-proof` | Add social proof elements | 10 |
| `/urgency` | Build ethical urgency | 8 |
| `/churn` | Predict and prevent churn | 15 |
| `/onboarding` | Optimize user onboarding | 12 |
| `/reactivate` | Win back inactive users | 12 |
| `/norms` | Analyze social norms | 10 |
| `/survey` | Design behavioral surveys | 12 |
| `/experiment` | Design A/B experiments | 15 |

## Pricing

| Tier | Credits | Price |
|------|---------|-------|
| Free trial | 100 | $0 |
| Starter | 500 | $5 |
| Standard | 2,000 | $20 |
| Pro | 10,000 | $100 |

1 credit = $0.01. Purchase at [phoslabs.io/credits](https://phoslabs.io/credits).

## Access Methods

| Method | URL | Auth |
|--------|-----|------|
| REST API | `phoslabs.io/api/v1/*` | Bearer token |
| MCP Server | `mcp.phoslabs.io` | OAuth 2.1 |
| x402 Micropayments | `phoslabs.io/x402/*` | USDC on Base L2 |

## OpenAPI Spec

Full spec at: `https://phoslabs.io/api/v1/openapi.json`

## MCP Integration

Connect in Claude, Cursor, or any MCP-compatible client:

```json
{
  "mcpServers": {
    "behavioral-science": {
      "url": "https://mcp.phoslabs.io/mcp"
    }
  }
}
```

## License

MIT