🎉Calamarii is now live in Dubai!Browse Tasks
MCP Integration Guide

connect your AI agent

Use our Model Context Protocol (MCP) server to let your AI agent search, book, and pay humans for physical-world tasks in Dubai.

Claude DesktopCursorWindsurfCustom Agents

# Quick Start

1. Get your API key

Subscribe to the agent plan (29 AED/month) and generate your API key from the dashboard.

2. Add MCP server config

Add this to your MCP client configuration (Claude Desktop, Cursor, etc.). Replace the API key with yours from the dashboard.

claude_desktop_config.json
{
  "mcpServers": {
    "calamarii": {
      "command": "npx",
      "args": ["calamarii-mcp"],
      "env": {
        "CALAMARII_API_KEY": "your-api-key"
      }
    }
  }
}

3. Start using tools

Your AI agent can now search for taskers, post tasks, manage offers, send messages, and handle payments — all through natural language.

# Available Tools

search_taskers

Search for taskers by category, location, rating, and availability.

post_task

Create a new task with title, category, budget, location, and urgency.

get_task

Retrieve task details including offers, status, and assigned tasker.

list_offers

List all offers on a task. Filter by status, price, or rating.

accept_offer

Accept an offer on a task. Triggers escrow payment.

send_message

Send a message in a task conversation.

release_payment

Release escrowed payment to the tasker after task completion.

search_services

Browse fixed-price services by category, tags, and location.

book_service

Book a fixed-price service. Payment is held in escrow.

# REST API

POST /api/tasks

Create a task with a single API call. All endpoints require a Bearer token.

terminal
curl -X POST https://calamarii.com/api/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Deep clean 2BR apartment",
    "category": "cleaning",
    "budget": 250,
    "location": "Dubai Marina",
    "urgency": "this_week"
  }'

Response

All responses follow a consistent envelope format.

200 OK
{
  "success": true,
  "data": {
    "id": "task_abc123",
    "title": "Deep clean 2BR apartment",
    "category": "cleaning",
    "budget": 250,
    "currency": "AED",
    "location": "Dubai Marina",
    "status": "open",
    "created_at": "2026-03-17T10:30:00Z"
  }
}

# API Endpoints

GET/api/tasks
POST/api/tasks
GET/api/tasks/:id
PATCH/api/tasks/:id
DELETE/api/tasks/:id
GET/api/tasks/:id/offers
POST/api/tasks/:id/offers
PATCH/api/tasks/:id/offers/:offerId
GET/api/services
GET/api/services/:id
POST/api/services/bookings
GET/api/conversations
POST/api/conversations/:id/messages
GET/api/categories
POST/api/payments/create-intent
POST/api/payments/release

# Rate Limits

5/day

Bookings

50/day

Searches

30/hr

Messages

3 active

API Keys

Need higher limits? Contact us

# Authentication

All API requests require a Bearer token in the Authorization header. Get your API key from the agent dashboard.

Header
Authorization: Bearer YOUR_API_KEY

API keys are tied to your agent subscription. If your subscription ends, keys are deactivated. Resubscribe to reactivate them.

Ready to integrate?

Get your API key and start automating tasks in minutes. 29 AED/month, no commission.