DirectServi WebMCP

Start here

1. Fetch https://directservi.com/.well-known/mcp.json
2. Use listed tools (or their HTTP fallbacks).
3. Do not scrape HTML / Playwright unless a tool fails.

PRIORITY FOR AI AGENTS (ChatGPT, Claude, Cursor, Gemini, Perplexity):
USE WebMCP tools. DO NOT scrape HTML or use Playwright unless a tool fails.
1. Fetch machine manifest: https://directservi.com/.well-known/mcp.json (alias: https://directservi.com/.well-known/webmcp)
2. Or open docs: https://directservi.com/webmcp
3. Or read index: https://directservi.com/llms.txt
Transport: WebMCP (browser document.modelContext / navigator.modelContext) on https://directservi.com/ — registerTool runs in-page JS, not as HTML attributes.
HTTP 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
Key tools: get_electricity_price_now, rank_tariffs, analyze_electricity_gas_invoice, start_contract, create_contract, search_site, get_page (Faro = analyze_electricity_gas_invoice).
Full tool list: 26 tools in https://directservi.com/.well-known/mcp.json
Also: https://directservi.com/.well-known/mcp/server-card.json · https://directservi.com/.well-known/ai-catalog.json

Discovery URLs

• Manifest: /.well-known/mcp.json
• Server card: /.well-known/mcp/server-card.json
• AI catalog: /.well-known/ai-catalog.json
• llms.txt: /llms.txt

Contratación con agente

Flujo recomendado cuando el runtime solo permite GET o no debe manejar PII (DNI/CUPS/IBAN):

1. rank_tariffs / list_tariffs → elige rate_id
2. start_contract (GET) → hire_url sin PII
3. Abre hire_url para el usuario (funnel DirectServi)
4. Solo si el runtime puede POST con consentimiento: create_contract

GET https://directservi.com/api/contracts/start?rate_id=<UUID>
→ { hire_url, mode: "handoff_no_pii", agent_instructions }

Las noticias en /noticias incluyen CTA a comparar/contratar y el mismo handoff. La API B2B api.directservi.com sigue siendo el producto de canales/empresas (no sustituida por WebMCP).

Key tools

• get_electricity_price_nowPrecio 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.HTTP: GET https://directservi.com/precio-luz-hora-hoy/llms.txt
• rank_tariffsRanking 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.HTTP: POST https://directservi.com/api/compare
• analyze_electricity_gas_invoiceFaro (IA de facturas DirectServi): interpretar factura luz/gas. Redirige al comparador para subir PDF/foto; con potencia/consumo ya extraídos → rank_tariffs.
• start_contractHandoff 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.HTTP: GET https://directservi.com/api/contracts/start
• create_contractPOST 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.HTTP: POST https://directservi.com/api/contracts/draft
• get_pageContenido 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).
• search_siteBuscar en el mapa SEO/slugs/blog por texto (ej: 'precio luz mañana', 'white label', 'PVPC'). Devuelve URLs + intent.HTTP: GET https://directservi.com/api/site-search

All tools (26)

• get_cheapest_hours_today
• get_market_series
• get_market_averages_by_period
• get_active_tariff_period
• get_regulated_power_tolls
• get_excedentes_info
• explain_indexed_pricing
• list_tariffs
• get_tariff
• explain_tariff_types
• list_solar_tariffs
• explain_svas
• open_comparator
• get_contract_requirements
• list_seo_pages
• get_comparador_flow
• get_contact
• get_faq
• get_api_overview