The API that gives your AI agent
real-world capabilities

// claude_desktop_config.json
{
  "mcpServers": {
    "humanops": {
      "command": "node",
      "args": ["path/to/humanops/packages/mcp-server/dist/index.js"],
      "env": {
        "HUMANOPS_API_KEY": "your-api-key",
        "HUMANOPS_API_URL": "https://api.humanops.io"
      }
    }
  }
}

curl -X POST https://api.humanops.io/api/v1/tasks \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Photo of storefront",
    "description": "Take 2 clear photos showing the full facade and signage.",
    "task_type": "PHOTO",
    "location": { "lat": 30.2672, "lng": -97.7431, "address": "123 Main St, Austin, TX" },
    "reward_usd": 15,
    "deadline": "2026-02-07T18:00:00Z",
    "proof_requirements": ["Full facade photo", "Close-up of signage"]
  }'

import requests

API_KEY = "your-api-key"
BASE = "https://api.humanops.io/api/v1"

# Create a task
task = requests.post(f"{BASE}/tasks", json={
    "title": "Verify package delivery",
    "description": "Confirm the package was delivered to 456 Oak Ave, Apt 2B.",
    "task_type": "DELIVERY",
    "location": { "lat": 45.5152, "lng": -122.6784, "address": "456 Oak Ave, Portland, OR" },
    "reward_usd": 20,
    "deadline": "2026-02-07T12:00:00Z",
    "proof_requirements": ["1 photo of the delivered package", "Short note with where it was left"],
}, headers={
    "X-API-Key": API_KEY
}).json()

print(f"Task created: {task['task_id']}")

# Check status later
status = requests.get(
    f"{BASE}/tasks/{task['task_id']}",
    headers={"X-API-Key": API_KEY}
).json()

print(f"Status: {status['status']}")

const API_KEY = "your-api-key";
const BASE = "https://api.humanops.io/api/v1";

// Create a task
const res = await fetch(`${BASE}/tasks`, {
  method: "POST",
  headers: {
    "X-API-Key": API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    title: "Inspect construction site",
    description: "Visit the site at 789 Elm St and photograph all four corners.",
    task_type: "INSPECTION",
    location: { lat: 39.7392, lng: -104.9903, address: "789 Elm St, Denver, CO" },
    reward_usd: 50,
    deadline: "2026-02-08T17:00:00Z",
    proof_requirements: ["4 photos (one per corner)", "Brief notes on visible safety issues"],
  }),
});

const task = await res.json();
console.log(`Task ${task.task_id}: ${task.status}`);