{"schema_version":"2.0","name":"DirectServi WebMCP","description":"Hiper-completo: mercado OMIE/indexadas, ranking tarifas, peajes, Faro, contrato online, SEO/AEO y API B2B. Cualquier pregunta que la web pueda responder. AGENTS: use these tools; DO NOT scrape HTML.","url":"https://directservi.com","transport":"webmcp","version":"2.0.0","documentation":"https://directservi.com/webmcp","instructions":"PRIORITY FOR AI AGENTS (ChatGPT, Claude, Cursor, Gemini, Perplexity):\nUSE WebMCP tools. DO NOT scrape HTML or use Playwright unless a tool fails.\n1. Fetch machine manifest: https://directservi.com/.well-known/mcp.json (alias: https://directservi.com/.well-known/webmcp)\n2. Or open docs: https://directservi.com/webmcp\n3. Or read index: https://directservi.com/llms.txt\nTransport: WebMCP (browser document.modelContext / navigator.modelContext) on https://directservi.com/ — registerTool runs in-page JS, not as HTML attributes.\nHTTP fallbacks (no browser): https://directservi.com/api/compare , https://directservi.com/api/market-prices , https://directservi.com/api/tariffs , POST https://directservi.com/api/contracts/draft\nKey tools: get_electricity_price_now, rank_tariffs, analyze_electricity_gas_invoice, start_contract, create_contract, search_site, get_page (Faro = analyze_electricity_gas_invoice).\nFull tool list: 26 tools in https://directservi.com/.well-known/mcp.json\nAlso: https://directservi.com/.well-known/mcp/server-card.json · https://directservi.com/.well-known/ai-catalog.json","remotes":[{"type":"webmcp","url":"https://directservi.com/","name":"directservi-webmcp","title":"DirectServi WebMCP","description":"Browser WebMCP (document.modelContext). Prefer tools over scraping."}],"capabilities":{"tools":true,"resources":false,"prompts":false},"discovery":{"llms_txt":"https://directservi.com/llms.txt","sitemap":"https://directservi.com/sitemap.xml","mcp":"https://directservi.com/.well-known/mcp.json","server_card":"https://directservi.com/.well-known/mcp/server-card.json","ai_catalog":"https://directservi.com/.well-known/ai-catalog.json","webmcp_docs":"https://directservi.com/webmcp","compare":"https://directservi.com/api/compare","market_prices":"https://directservi.com/api/market-prices","market_averages":"https://directservi.com/api/market-averages","tariffs":"https://directservi.com/api/tariffs","contracts":"https://directservi.com/api/contracts/draft","docs":"https://docs.directservi.com","api":"https://api.directservi.com","comparator":"https://directservi.com/?v=default&utm_source=landing&utm_medium=site&utm_campaign=home","contact":{"phone":"+34 954 05 53 23","phoneHref":"tel:+34954055323","mobile":"+34 614 31 68 53","mobileHref":"tel:+34614316853","whatsapp":"34614316853","email":"info@directservi.com","emailHref":"mailto:info@directservi.com"}},"domains":{"directservi.com":"Público: precios, comparador, landings, WebMCP","directservi.app":"CRM privado","docs.directservi.com":"Docs API","api.directservi.com":"API B2B"},"categories":{"market":"Precios OMIE, periodos, potencia BOE 2.0/3.0/6.1, indexadas","tariffs":"Ranking, catálogo, Faro, comparador","contract":"Requisitos y alta online","content":"SEO pages, FAQ, búsqueda","api":"Productos B2B"},"tools":[{"name":"get_electricity_price_now","description":"Precio de mercado OMIE AHORA (España): €/MWh, €/kWh, tramo actual, mín/máx/media del día. Base de tarifas INDEXADAS. Actualizado ~15 min.","inputSchema":{"type":"object","properties":{}},"annotations":{"readOnlyHint":true,"title":"Precio ahora"},"category":"market","http":{"method":"GET","url":"https://directservi.com/precio-luz-hora-hoy/llms.txt"}},{"name":"get_cheapest_hours_today","description":"Horas/tramos más baratos HOY en OMIE. Útil solo con tarifa INDEXADA (fija = mismo precio 24h). Recomienda lavadora, EV, termos.","inputSchema":{"type":"object","properties":{}},"annotations":{"readOnlyHint":true,"title":"Horas baratas"},"category":"market","http":{"method":"GET","url":"https://directservi.com/precio-luz-cuarto-horario/llms.txt"}},{"name":"get_market_series","description":"Serie histórica de precios OMIE. from/to YYYY-MM-DD, res=quarter|hour|day. Para gráficas, 'precios de enero', rangos personalizados. Tarifas indexadas siguen esta serie + fee.","inputSchema":{"type":"object","properties":{"from":{"type":"string","description":"YYYY-MM-DD"},"to":{"type":"string","description":"YYYY-MM-DD"},"res":{"type":"string","enum":["quarter","hour","day"]}},"required":["from","to"]},"annotations":{"readOnlyHint":true,"title":"Serie OMIE"},"category":"market","http":{"method":"GET","url":"https://directservi.com/api/market-prices","note":"?from=&to=&res="}},{"name":"get_market_averages_by_period","description":"Medias OMIE por periodo tarifario. peaje=2.0TD (Punta/Llano/Valle), 3.0TD o 6.1TD (P1–P6), o all. window_days=30|90|180. Responde '¿qué precios hemos tenido?' / 'media P3 últimos 3 meses'.","inputSchema":{"type":"object","properties":{"peaje":{"type":"string","enum":["2.0TD","3.0TD","6.1TD","all"]},"window_days":{"type":"number"}}},"annotations":{"readOnlyHint":true,"title":"Medias por periodo"},"category":"market","http":{"method":"GET","url":"https://directservi.com/api/market-averages"}},{"name":"get_active_tariff_period","description":"Periodo tarifario ACTIVO ahora (calendario CNMC). 2.0TD: Punta/Llano/Valle. 3.0TD/6.1TD: P1–P6. Afecta potencia y PVPC/indexadas.","inputSchema":{"type":"object","properties":{"peaje":{"type":"string","enum":["2.0TD","3.0TD","6.1TD"]}}},"annotations":{"readOnlyHint":true,"title":"Periodo activo"},"category":"market","http":{"method":"GET","url":"https://directservi.com/api/periods/now"}},{"name":"get_regulated_power_tolls","description":"Peajes T&D de potencia BOE/CNMC 2025 (€/kW·día y €/kW·año) por peaje. peaje=2.0TD|3.0TD|6.1TD|all. No incluye cargos MITECO. Coste FIJO aparte de la energía.","inputSchema":{"type":"object","properties":{"peaje":{"type":"string","enum":["2.0TD","3.0TD","6.1TD","all"]}}},"annotations":{"readOnlyHint":true,"title":"Potencia BOE"},"category":"market","http":{"method":"GET","url":"https://directservi.com/api/power-tolls?peaje=all"}},{"name":"get_excedentes_info","description":"Estado de compensación de excedentes/autoconsumo. OMIE NO publica fichero específico; si has_data=false, usar medias/serie de mercado como referencia. No inventar un precio de excedentes.","inputSchema":{"type":"object","properties":{}},"annotations":{"readOnlyHint":true,"title":"Excedentes"},"category":"market","http":{"method":"GET","url":"https://directservi.com/api/excedentes"}},{"name":"explain_indexed_pricing","description":"Cómo funciona una tarifa INDEXADA (pool OMIE + fee mensual o €/MWh). Diferencia vs fija y vs 'al ritmo del mercado' con margen. Usa get_market_series / averages para cifras.","inputSchema":{"type":"object","properties":{}},"annotations":{"readOnlyHint":true,"title":"Indexada explicada"},"category":"market"},{"name":"rank_tariffs","description":"Ranking tarifas luz 2.0TD €/mes (IE+IVA). power_kw + consumption_kwh (+ periodos). rank_by=total|power|energy; profile=second_home|seasonal_summer|seasonal_winter|low_usage; solar/virtual_battery=any|required|excluded. Top + comparator_url.","inputSchema":{"type":"object","properties":{"power_kw":{"type":"number"},"power_p1_kw":{"type":"number"},"power_p2_kw":{"type":"number"},"consumption_kwh":{"type":"number"},"consumption_p1_kwh":{"type":"number"},"consumption_p2_kwh":{"type":"number"},"consumption_p3_kwh":{"type":"number"},"billing_days":{"type":"number"},"include_social_bonus":{"type":"boolean"},"include_meter_rental":{"type":"boolean"},"current_bill_eur":{"type":"number"},"postal_code":{"type":"string"},"limit":{"type":"number"},"rank_by":{"type":"string","enum":["total","power","energy"],"description":"Orden: total factura | término potencia | término energía"},"profile":{"type":"string","enum":["default","second_home","seasonal_summer","seasonal_winter","low_usage"],"description":"Preset de uso si faltan kW/kWh (2ª residencia, estacional…)"},"solar":{"type":"string","enum":["any","required","excluded"],"description":"Filtrar tarifas con compensación/autoconsumo"},"virtual_battery":{"type":"string","enum":["any","required","excluded"],"description":"Filtrar tarifas con batería virtual"}}},"annotations":{"readOnlyHint":true,"title":"Ranking tarifas"},"category":"tariffs","http":{"method":"POST","url":"https://directservi.com/api/compare"}},{"name":"list_tariffs","description":"Catálogo de tarifas luz 2.0TD activas (compañía, nombre, precios energía/potencia, indexada, fee, permanencia). Para 'qué tarifas tenéis' / 'precios de Niba'.","inputSchema":{"type":"object","properties":{"company":{"type":"string","description":"Filtro opcional (Niba, Repsol…)"},"indexed_only":{"type":"boolean"},"limit":{"type":"number"}}},"annotations":{"readOnlyHint":true,"title":"Listar tarifas"},"category":"tariffs","http":{"method":"GET","url":"https://directservi.com/api/tariffs"}},{"name":"get_tariff","description":"Detalle de una tarifa por rate_id (UUID) o nombre aproximado.","inputSchema":{"type":"object","properties":{"rate_id":{"type":"string"},"name":{"type":"string"}}},"annotations":{"readOnlyHint":true,"title":"Detalle tarifa"},"category":"tariffs","http":{"method":"GET","url":"https://directservi.com/api/tariffs"}},{"name":"explain_tariff_types","description":"Fija vs indexada vs mixta vs PVPC. Pros/cons y para quién.","inputSchema":{"type":"object","properties":{}},"annotations":{"readOnlyHint":true,"title":"Tipos tarifa"},"category":"tariffs"},{"name":"analyze_electricity_gas_invoice","description":"Faro (IA de facturas DirectServi): interpretar factura luz/gas. Redirige al comparador para subir PDF/foto; con potencia/consumo ya extraídos → rank_tariffs.","inputSchema":{"type":"object","properties":{"file_hint":{"type":"string"},"redirect":{"type":"boolean"}}},"annotations":{"readOnlyHint":false,"title":"Faro factura"},"category":"tariffs"},{"name":"list_solar_tariffs","description":"Tarifas con compensación de excedentes / solar (rank_tariffs con solar=required). Opcional virtual_battery=required y perfil de consumo.","inputSchema":{"type":"object","properties":{"power_kw":{"type":"number"},"consumption_kwh":{"type":"number"},"virtual_battery":{"type":"string","enum":["any","required","excluded"]},"rank_by":{"type":"string","enum":["total","power","energy"]},"limit":{"type":"number"}}},"annotations":{"readOnlyHint":true,"title":"Tarifas solar"},"category":"tariffs","http":{"method":"POST","url":"https://directservi.com/api/compare"}},{"name":"explain_svas","description":"Explica los 2 SVAs clave DirectServi: autoconsumo/excedentes vs batería virtual (sin inventar precios OMIE). Catálogo en /api/svas.","inputSchema":{"type":"object","properties":{}},"annotations":{"readOnlyHint":true,"title":"SVAs"},"category":"tariffs","http":{"method":"GET","url":"https://directservi.com/api/svas"}},{"name":"open_comparator","description":"Abrir el comparador DirectServi en el navegador del usuario.","inputSchema":{"type":"object","properties":{"postal_code":{"type":"string"},"supply":{"type":"string","enum":["luz","gas"]}}},"annotations":{"readOnlyHint":false,"title":"Abrir comparador"},"category":"tariffs"},{"name":"get_contract_requirements","description":"Qué datos hacen falta para contratar. España only. Si el agente SOLO puede GET / no debe manejar PII: usar start_contract (hire_url) y que el usuario complete DNI/CUPS/IBAN en el funnel.","inputSchema":{"type":"object","properties":{}},"annotations":{"readOnlyHint":true,"title":"Requisitos"},"category":"contract"},{"name":"start_contract","description":"Handoff sin PII (GET). Devuelve hire_url del funnel con rate_id. Para Claude.ai / agentes solo-lectura: preferir ESTO frente a create_contract. El usuario introduce DNI/CUPS/IBAN en DirectServi.","inputSchema":{"type":"object","properties":{"rate_id":{"type":"string","description":"UUID de la tarifa elegida (de rank_tariffs)"}}},"annotations":{"readOnlyHint":true,"title":"Abrir contratar"},"category":"contract","http":{"method":"GET","url":"https://directservi.com/api/contracts/start"}},{"name":"create_contract","description":"POST con PII (DNI, CUPS, IBAN…). Solo si el runtime soporta POST (WebMCP en navegador) Y el usuario aporta los datos. Si el agente solo puede GET o no debe manejar PII → usar start_contract.","inputSchema":{"type":"object","properties":{"first_name":{"type":"string"},"last_name":{"type":"string"},"dni":{"type":"string"},"cups":{"type":"string"},"supply_address":{"type":"string"},"supply_postal_code":{"type":"string"},"supply_city":{"type":"string"},"supply_province":{"type":"string"},"iban":{"type":"string"},"email":{"type":"string"},"phone":{"type":"string"},"rate_id":{"type":"string"},"submit":{"type":"boolean"},"redirect":{"type":"boolean"}},"required":["first_name","last_name","dni","cups","supply_address","supply_postal_code","supply_city","supply_province","iban","email","phone"]},"annotations":{"readOnlyHint":false,"title":"Crear contrato"},"category":"contract","http":{"method":"POST","url":"https://directservi.com/api/contracts/draft"}},{"name":"get_page","description":"Contenido markdown (llms.txt) de una página canónica. path ej: /precio-luz-hora-hoy, /pvpc-hoy, /comparador-tarifas-luz, /contratar-luz-online, / (llms global).","inputSchema":{"type":"object","properties":{"path":{"type":"string","description":"Ruta con / inicial"}},"required":["path"]},"annotations":{"readOnlyHint":true,"title":"Página llms"},"category":"content"},{"name":"list_seo_pages","description":"Mapa de URLs canónicas, intents y dominios (.com/.app/docs/api).","inputSchema":{"type":"object","properties":{}},"annotations":{"readOnlyHint":true,"title":"Mapa SEO"},"category":"content","http":{"method":"GET","url":"https://directservi.com/api/site-map"}},{"name":"search_site","description":"Buscar en el mapa SEO/slugs/blog por texto (ej: 'precio luz mañana', 'white label', 'PVPC'). Devuelve URLs + intent.","inputSchema":{"type":"object","properties":{"query":{"type":"string"}},"required":["query"]},"annotations":{"readOnlyHint":true,"title":"Buscar en site"},"category":"content","http":{"method":"GET","url":"https://directservi.com/api/site-search"}},{"name":"get_comparador_flow","description":"Qué es DirectServi y flujo comparar → contratar online.","inputSchema":{"type":"object","properties":{}},"annotations":{"readOnlyHint":true,"title":"Flujo"},"category":"content"},{"name":"get_contact","description":"Email, teléfono y canales de contacto DirectServi.","inputSchema":{"type":"object","properties":{}},"annotations":{"readOnlyHint":true,"title":"Contacto"},"category":"content"},{"name":"get_faq","description":"FAQ AEO: contratar online, vs CNMC, Faro, API, precio luz hoy, PVPC.","inputSchema":{"type":"object","properties":{}},"annotations":{"readOnlyHint":true,"title":"FAQ"},"category":"content"},{"name":"get_api_overview","description":"API B2B: tarifas, Faro, white label, marco retributivo, contratos, webhooks. Docs y registro.","inputSchema":{"type":"object","properties":{}},"annotations":{"readOnlyHint":true,"title":"API B2B"},"category":"api"}],"canonical":"https://directservi.com/.well-known/mcp.json"}