Beaches of Mallorca MCP

A read-only MCP server providing live swimming and family condition scores, beach guides, and current weather data for 77 beaches in Mallorca. It allows AI agents to retrieve real-time conditions, find the best beaches for specific activities, list available beaches, and access detailed guides in multiple languages.

Visit Beaches of Mallorca

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

Vendor evidenceStreamable HTTPNo sign-inEndpoint checked 2026-11-01Operated by Beaches of Mallorca

MCP endpoint (Streamable HTTP)

https://beachesofmallorca.com/mcp

Vendor documentation

What you can do with it

Find the best beach for a family swim in Mallorca right now
Check current conditions at a specific beach like Es Trenc
Identify the calmest beach in north Mallorca this morning
Access beach guides and weather data for trip planning

Source and maintenance

Vendor evidenceRegistry 1.0.0

mcp-registry: com.beachesofmallorca/beaches@1.0.0 Project website

Protocol and capabilities

Server: beaches-of-mallorca 1.0.0
MCP protocol: 2025-06-18
Tools: 4 advertised
Resources: Not advertised
Resource templates: Not advertised
Prompts: Not advertised

Server-advertised capabilities

{
  "tools": {
    "listChanged": false
  }
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

Live swimming and family conditions and reviewed guides for Mallorca beaches, from beachesofmallorca.com. Conditions scores describe weather and sea conditions on a scale of 0 to 10. Seasonal crowd estimates are provisional and do not affect scores or ranking. They are not a safety check: currents, flags, jellyfish, water quality and lifeguards are not verified. Follow local flags and lifeguards. Cite https://beachesofmallorca.com when you use the data.

Tools

4 advertised

get_conditions — Current beach conditions

Advertised by the server during the last successful anonymous check.

Advertised read-only

Current swimming and family scores (0 to 10) with water temperature, wave height and wind for Mallorca beaches, from the hourly forecast and official AEMET warnings. Optionally filter to one beach or one region. Each answer states when it was generated and until when it is valid.

get_conditions input schema

{
  "type": "object",
  "properties": {
    "beach": {
      "type": "string",
      "description": "Beach slug or name, for example \"es-trenc\" or \"Cala Tuent\"."
    },
    "region": {
      "enum": [
        "north",
        "east",
        "south",
        "west",
        "palma-bay"
      ],
      "type": "string",
      "description": "Part of the island. Omit for all."
    },
    "language": {
      "enum": [
        "en",
        "de",
        "es",
        "ca"
      ],
      "type": "string",
      "description": "Language of names and labels: en, de, es or ca. Default en."
    }
  },
  "additionalProperties": false
}

get_conditions annotations

{
  "readOnlyHint": true,
  "openWorldHint": false
}

best_beaches_now — Best beaches right now

Advertised by the server during the last successful anonymous check.

Advertised read-only

The Mallorca beaches ranked by conditions score, with provisional seasonal crowd estimates shown separately. Only beaches with a valid current forecast are included.

best_beaches_now input schema

{
  "type": "object",
  "properties": {
    "mode": {
      "enum": [
        "swimming",
        "family"
      ],
      "type": "string",
      "description": "Default swimming."
    },
    "limit": {
      "type": "integer",
      "maximum": 20,
      "minimum": 1,
      "description": "Upper bound, default 5. Good-fit selection can return fewer beaches."
    },
    "region": {
      "enum": [
        "north",
        "east",
        "south",
        "west",
        "palma-bay"
      ],
      "type": "string",
      "description": "Part of the island. Omit for all."
    },
    "language": {
      "enum": [
        "en",
        "de",
        "es",
        "ca"
      ],
      "type": "string",
      "description": "Language of names and labels: en, de, es or ca. Default en."
    }
  },
  "additionalProperties": false
}

best_beaches_now annotations

{
  "readOnlyHint": true,
  "openWorldHint": false
}

list_beaches — List beaches

Advertised by the server during the last successful anonymous check.

Advertised read-only

All beaches covered by the site, with slug, name, municipality and region. Use a slug with get_beach_guide or get_conditions.

list_beaches input schema

{
  "type": "object",
  "properties": {
    "region": {
      "enum": [
        "north",
        "east",
        "south",
        "west",
        "palma-bay"
      ],
      "type": "string",
      "description": "Part of the island. Omit for all."
    }
  },
  "additionalProperties": false
}

list_beaches annotations

{
  "readOnlyHint": true,
  "openWorldHint": false
}

get_beach_guide — Beach guide

Advertised by the server during the last successful anonymous check.

Advertised read-only

The reviewed guide for one beach in Markdown: overview, access and parking, sand and water, facilities, crowds, wind, hazards and the official sources used.

get_beach_guide input schema

{
  "type": "object",
  "required": [
    "beach"
  ],
  "properties": {
    "beach": {
      "type": "string",
      "description": "Beach slug or name, for example \"es-trenc\" or \"Cala Tuent\"."
    },
    "language": {
      "enum": [
        "en",
        "de",
        "es",
        "ca"
      ],
      "type": "string",
      "description": "Language of names and labels: en, de, es or ca. Default en."
    }
  },
  "additionalProperties": false
}

get_beach_guide annotations

{
  "readOnlyHint": true,
  "openWorldHint": false
}

Prompts

Not advertised

No prompt definitions available.

Resources

Not advertised

No resource definitions available.

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks: 1 of 1 (100%)
Average latency: 390 ms
95th percentile latency: 390 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

Nov 1, 2026, 7:14 AM UTC · probe · passed · 390 ms · metadata changed · 4 tool(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.

Claude Code configuration

claude mcp add --transport http beaches-of-mallorca-mcp https://beachesofmallorca.com/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).

Codex configuration

codex mcp add beaches-of-mallorca-mcp --url https://beachesofmallorca.com/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable beaches-of-mallorca-mcp in your MCP settings.

Cursor configuration

{
  "mcpServers": {
    "beaches-of-mallorca-mcp": {
      "url": "https://beachesofmallorca.com/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).

Cline configuration

{
  "mcpServers": {
    "beaches-of-mallorca-mcp": {
      "type": "streamableHttp",
      "url": "https://beachesofmallorca.com/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start beaches-of-mallorca-mcp and inspect its tools.

VS Code configuration

{
  "servers": {
    "beaches-of-mallorca-mcp": {
      "type": "http",
      "url": "https://beachesofmallorca.com/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.

Gemini CLI configuration

gemini mcp add --transport http beaches-of-mallorca-mcp https://beachesofmallorca.com/mcp

Claude Desktop

Merge this into claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\), then restart Claude Desktop.

Claude Desktop configuration

{
  "mcpServers": {
    "beaches-of-mallorca-mcp": {
      "url": "https://beachesofmallorca.com/mcp"
    }
  }
}

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.

Windsurf configuration

{
  "mcpServers": {
    "beaches-of-mallorca-mcp": {
      "serverUrl": "https://beachesofmallorca.com/mcp"
    }
  }
}

Let your agent find its tools

Find servers like Beaches of Mallorca MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows

See all 3,948

Do you run Beaches of Mallorca MCP?

Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.

Claim this listing

Beaches of Mallorca MCP

Endpoint and access

What you can do with it

Source and maintenance

Protocol and capabilities

Server-provided instructions

Tools

Prompts

Resources

30-day availability

Maintenance history

Connect from your client

Claude Code

Codex

Cursor

Cline

VS Code

Gemini CLI

Claude Desktop

Windsurf

Let your agent find its tools

Other productivity and knowledge servers

Do you run Beaches of Mallorca MCP?