Idealista MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| COTLET_API_KEY | Yes | API key for Cotlet.dev. Get your API key at https://cotlet.dev/app. Without COTLET_API_KEY a tool call answers: "Set COTLET_API_KEY. Get a key at https://cotlet.dev/app". |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Idealista through Cotlet.dev. Call idealista_guide first. Set COTLET_API_KEY (https://cotlet.dev/app).
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| idealista_guideA | How to work in Idealista (list and update your listings): its screens and the sign-in link. Call this first. |
| idealista_statusB | Check that your Cotlet.dev account and Idealista are ready: account, credits and Idealista connection. |
| idealista_openB | Open a Idealista page in your signed-in Cloud Browser (default https://www.idealista.com) to work with list and update your listings. |
| idealista_readA | Read the current Idealista page: its text and numbered buttons, links and fields. |
| idealista_clickB | Click a numbered element on the current Idealista page. |
| idealista_typeB | Type text into a numbered field on the current Idealista page. |
| idealista_closeA | Close the Idealista browser session when the work is done, so credits stop running. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 7 tools
The tools form a clear browser-automation loop (open → read → click/type → close) with distinct roles. The only soft overlap is between idealista_guide and idealista_status, since both are 'call first' onboarding/readiness checks, which could cause hesitation about which to invoke initially.
All seven tools use the same vendor-prefixed snake_case pattern (idealista_verb), with consistent verb-style suffixes (guide, status, open, read, click, type, close). No mixed conventions or casing deviations.
Seven tools is well-scoped for a browser-driven listing-management wrapper: each one maps to a distinct step (guidance, status, session lifecycle, and page interaction primitives). Nothing feels redundant or bloated.
The core session lifecycle and interaction primitives are covered, but the browser-control surface has notable gaps: no scroll, no select/dropdown handling, no keypress/submit, and no screenshot or wait-for-load. Since the actual listing create/update operations must be reproduced through this thin primitive set, agents may hit dead ends on common Idealista form flows.