# VanMoose API Platform — Full Reference
> 72 developer utility APIs. One key. One MCP server. https://vanmoose.cc

## Quick Start
1. Sign up: https://vanmoose.cc/sign-up (free, no credit card)
2. Get API key: auto-issued on signup (vm_live_xxx format)
3. Call any API: curl -H "X-VanMoose-Key: vm_live_xxx" https://emailverify.vanmoose.cc/v1/verify?email=test@example.com

## MCP Server (for AI agents)
```json
{
  "mcpServers": {
    "vanmoose": {
      "command": "npx",
      "args": ["-y", "@vanmoose/mcp-server"],
      "env": { "VANMOOSE_API_KEY": "vm_live_your_key_here" }
    }
  }
}
```
This registers 190 tools from 72 APIs. The agent can call any tool directly.

## JavaScript SDK
```bash
npm install @vanmoose/sdk
```
```typescript
import { createClient } from '@vanmoose/sdk'
const vm = createClient({ apiKey: 'vm_live_xxx' })
const result = await vm.emailVerify({ email: 'test@example.com' })
```

## Base URL Pattern
Each API has its own subdomain: https://{api-id}.vanmoose.cc/v1/{endpoint}
All share the same API key (X-VanMoose-Key header).

## Rate Limits & Quotas
4 independent quota pools based on API compute cost:
- Standard (36 APIs): baseline quotas
- Standard Reduced (4 APIs): heavier compute, reduced quotas
- Lite (30 APIs): lightweight utilities, 2x quotas
- Premium (2 APIs): Screenshot + PDF Generate, lowest quotas

| Plan  | Price    | Standard | Lite   | Premium |
|-------|----------|----------|--------|---------|
| Free  | $0/mo    | 200/mo   | 500/mo | 10/mo   |
| Pro   | $9.99/mo | 10K      | 20K    | 200     |
| Ultra | $49.99   | 100K     | 200K   | 1.2K    |
| Mega  | $199     | 1M       | 2M     | 6K      |

## Error Codes
- 401: Invalid/missing API key
- 402: Monthly quota exceeded
- 403: Scope violation (key not authorized for this API)
- 422: Validation error
- 429: Rate limited (check Retry-After header)

## Scoped API Keys
Keys can be scoped to limit access:
- Full Access: all 72 APIs (default)
- Category scope: restrict to one category (e.g., Validation, Web, Text)
- API scope: restrict to a single API (e.g., emailverify only)

Scope violations return 403 with code SCOPE_VIOLATION.
Create scoped keys in your dashboard at vanmoose.cc/dashboard/keys.
The MCP server automatically filters registered tools based on your key's scope.

## SLA & Reliability
- 99.5% monthly uptime commitment on all *.vanmoose.cc API endpoints
- Downtime = HTTP 5xx or 30s timeout for 5+ consecutive minutes
- Service credits: 10% (99.0-99.5%), 25% (95.0-99.0%), 50% (below 95.0%)
- Exclusions: scheduled maintenance (24h notice), client errors (4xx), force majeure
- Claim within 30 days: support@vanmoose.cc
- Full SLA: https://vanmoose.cc/sla
- Terms of Service: https://vanmoose.cc/terms

## OpenAPI Spec
Full machine-readable spec: https://vanmoose.cc/openapi.json

## All 72 APIs
See https://vanmoose.cc/llms.txt for the complete categorized list.
Each API endpoint supports both GET (query params) and POST (JSON body).
All responses are JSON. Binary APIs (screenshot, PDF) return base64 or direct binary.