Developer Documentation

Avvican Agent API

REST API + MCP server for AI agents — ChatGPT, Claude, Perplexity, Manus and others — to search vacation rentals, check real-time availability and create bookings in Gran Canaria.

MCP endpoint actions.json llms.txt Health

Base URL

https://avvican.com

All endpoints return application/json and include Access-Control-Allow-Origin: * headers.

MCP Server

MCPhttps://avvican.com/api/mcpStreamable HTTP · JSON-RPC 2.0

Native MCP server — connect Claude Desktop, Cursor, or any MCP-compatible client directly to Avvican's property data and availability API.

Available Tools

search_properties

Filter listings by location, guests, price

get_property

Full details for a single property by slug

check_availability

Real-time availability + pricing from Avaibook

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "avvican": {
      "url": "https://avvican.com/api/mcp",
      "transport": "http"
    }
  }
}

Cursor / older MCP clients (via mcp-remote)

{
  "mcpServers": {
    "avvican": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://avvican.com/api/mcp"]
    }
  }
}

Direct JSON-RPC call

curl -X POST https://avvican.com/api/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "id": 1,
    "params": {
      "name": "search_properties",
      "arguments": { "location": "Las Palmas", "guests": 4 }
    }
  }'

REST Endpoints

GET/api/propertiesList properties

Returns all vacation rentals with clean, flat JSON. All filters are optional — omit to get every listing.

Query Parameters

locationstringCity / area substring (e.g. "Las Palmas", "Maspalomas")

guestsintegerMinimum number of guests

minPricenumberMin price per night (EUR)

maxPricenumberMax price per night (EUR)

Example

curl "https://avvican.com/api/properties?location=Las%20Palmas&guests=4"

Response

{
  "data": [
    {
      "slug": "villa-mar",
      "title": "Villa Mar",
      "location": "Castillo Del Romeral",
      "guests": 6,
      "bedrooms": 3,
      "pricePerNight": 115,
      "coverImage": "https://cdn.sanity.io/...",
      "amenities": ["WiFi", "Piscina", "Terraza"],
      "avaibookId": "384955"
    }
  ],
  "total": 8
}

GET/api/properties/{slug}Get property detail

Full details for a single property, including all images, coordinates and amenities.

Query Parameters

slugpathrequiredProperty slug from the list endpoint

Example

curl "https://avvican.com/api/properties/villa-mar"

POST/api/properties/searchSearch properties (POST)

Same as GET /api/properties but accepts filters as JSON body. Prefer this when sending complex queries.

Request Body

locationstringCity or area substring

guestsintegerMinimum guests required

minPricenumberMinimum price per night (EUR)

maxPricenumberMaximum price per night (EUR)

Example

curl -X POST "https://avvican.com/api/properties/search" \
  -H "Content-Type: application/json" \
  -d '{"guests": 4, "maxPrice": 150}'

POST/api/availabilityCheck availability

Query Avaibook in real time for availability and total price.

Request Body

slugstringProperty slug (OR use avaibookId)

avaibookIdstringAvaibook ID from the property list

checkIndaterequiredYYYY-MM-DD

checkOutdaterequiredYYYY-MM-DD

guestsintegerNumber of guests (default: 2)

Example

curl -X POST "https://avvican.com/api/availability" \
  -H "Content-Type: application/json" \
  -d '{"slug":"villa-mar","checkIn":"2026-08-01","checkOut":"2026-08-08","guests":2}'

Response

{
  "available": true,
  "checkIn": "2026-08-01",
  "checkOut": "2026-08-08",
  "nights": 7,
  "guests": 2,
  "property": "Villa Mar",
  "pricing": {
    "pricePerNight": 115,
    "total": 945,
    "currency": "EUR"
  }
}

Integration Guides

ChatGPT / GPT Actions

OpenAPI

Import the OpenAPI 3.1 manifest as a Custom GPT Action. All endpoints, parameters and response schemas are defined.

/.well-known/actions.json ↗

Claude Desktop

MCP

Connect via the native MCP server. Tools appear automatically in Claude's tool palette after adding the config above.

/api/mcp ↗

Manus / Perplexity / RAG

REST

Use /api/properties for structured property data ideal for RAG pipelines. Every property also includes Schema.org JSON-LD on its web page.

/api/properties ↗

LLM context priming

llms.txt

Point your LLM to /llms.txt for a concise description of Avvican's business, zones, and API surface — optimized for context windows.

/llms.txt ↗

Need access or support?

info@avvican.com