🏠 La Palma 24 API

🚀 Quick Start

La Palma 24 offers two integration options: a REST API for traditional applications and an MCP Server (Model Context Protocol) for AI assistants like Claude, ChatGPT, and others.

🔌 REST API

Our REST API provides access to all vacation rentals, real-time availability checking, and price calculations.

Base URL

https://admin.la-palma24.net/api/

Authentication

The API requires an API key in the request header:

X-API-Key: YOUR_API_KEY

L3DvD3fpbdl6IubzCU7o-general-use

OpenAPI Specification

Full OpenAPI 3.1 specification is available for import into Postman, Swagger UI, or code generators:

📡 API Endpoints

GET /api/disponibilidad?fecha_llegada=2027-03-01&fecha_salida=2027-03-08&num_personas=4&municipio=Tazacorte

{
  "success": true,
  "total": 12,
  "data": [
    {
      "id_casa": "1234",
      "nombre": "Casa del Sol",
      "titulo": "Preciosa villa con piscina en Tazacorte",
      "municipio": "Tazacorte",
      "barrio": "El Puerto",
      "dormitorios": 2,
      "banios": 1,
      "personas_max": 4,
      "precio_base": 89.00,
      "urls": {
        "es": "https://www.la-palma24.net/es/ferienunterkunft/unterkunft/1234",
        "de": "https://www.la-palma24.net/de/ferienunterkunft/unterkunft/1234",
        "en": "https://www.la-palma24.net/en/ferienunterkunft/unterkunft/1234"
      }
    },
    ...
  ]
}

GET /api/propiedad/1234?idioma=en

🤖 MCP Server for AI Assistants

The Model Context Protocol (MCP) server enables AI assistants like Claude, ChatGPT, and others to directly search for vacation rentals in La Palma. This is the most modern way to integrate AI with real-world data.

MCP Server URL

https://mcp.la-palma24.net/

Endpoints

Source Code

Available Tools

Claude Desktop Integration

To use the MCP server with Claude Desktop, add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "lapalma24": {
      "url": "https://mcp.la-palma24.net/sse"
    }
  }
}

Example Conversation with AI

💻 Code Examples

JavaScript / Node.js

// Search available properties
const response = await fetch(
  'https://admin.la-palma24.net/api/disponibilidad?' + 
  new URLSearchParams({
    fecha_llegada: '2027-03-01',
    fecha_salida: '2027-03-08',
    num_personas: 4,
    municipio: 'Tazacorte'
  }), {
    headers: {
      'X-API-Key': 'L3DvD3fpbdl6IubzCU7o-general-use'
    }
  }
);

const data = await response.json();
console.log(`Found ${data.total} properties`);

data.data.forEach(prop => {
  console.log(`- ${prop.nombre}: €${prop.precio_base}/week`);
});

Python

import requests

# Search available properties
response = requests.get(
    'https://admin.la-palma24.net/api/disponibilidad',
    params={
        'fecha_llegada': '2027-03-01',
        'fecha_salida': '2027-03-08',
        'num_personas': 4,
        'municipio': 'Tazacorte'
    },
    headers={
        'X-API-Key': 'L3DvD3fpbdl6IubzCU7o-general-use'
    }
)

data = response.json()
print(f"Found {data['total']} properties")

for prop in data['data']:
    print(f"- {prop['nombre']}: €{prop['precio_base']}/week")

cURL

curl -X GET "https://admin.la-palma24.net/api/disponibilidad?fecha_llegada=2027-03-01&fecha_salida=2027-03-08&num_personas=4" \
  -H "X-API-Key: L3DvD3fpbdl6IubzCU7o-general-use"

PHP

$params = http_build_query([
    'fecha_llegada' => '2027-03-01',
    'fecha_salida' => '2027-03-08',
    'num_personas' => 4,
    'municipio' => 'Tazacorte'
]);

$opts = [
    'http' => [
        'method' => 'GET',
        'header' => 'X-API-Key: L3DvD3fpbdl6IubzCU7o-general-use'
    ]
];

$context = stream_context_create($opts);
$response = file_get_contents(
    "https://admin.la-palma24.net/api/disponibilidad?{$params}",
    false,
    $context
);

$data = json_decode($response, true);
echo "Found {$data['total']} properties\n";

🎯 Use Cases

🏝️ About La Palma

La Palma is one of the Canary Islands, Spain, known as "La Isla Bonita" (The Beautiful Island). It's a UNESCO Biosphere Reserve and the world's first Starlight Reserve, making it perfect for:

• Hiking – Over 1,000 km of marked trails including the famous GR-131
• Stargazing – Home to one of the world's most important astronomical observatories
• Nature – Volcanic landscapes, laurel forests, and black sand beaches
• Year-round climate – Mild temperatures between 18-28°C all year

Getting there: Direct flights from Germany (Frankfurt, Düsseldorf, Munich, Hamburg), UK, Switzerland (Zurich), and Netherlands (Amsterdam). Flight time approximately 4.5 hours from Central Europe.

📞 Support & Contact

For API integration questions or to request an API key:

• Email: la-palma24@la-palma24.net
• Phone: +34 682 89 48 29
• GitHub Issues: github.com/La-Palma-24/lapalma24-mcp/issues