Skip to main content
Glama
Sign In
deenesjakoruzh
maideo

maideo

by ikki-ai
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Remote

@maideo/mcp

Официальный сервер MCP (Model Context Protocol) для Maideo Agent API.

Позволяет любому AI-агенту, совместимому с MCP (Claude Desktop, Claude Code, ChatGPT desktop, Continue.dev, Cursor и т. д.), бронировать профессиональные услуги по уборке дома (ménage à domicile) в любой точке Франции «под ключ», без участия человека.

Что он делает

  • Проверяет покрытие по почтовому индексу

  • Предоставляет твердое ценовое предложение

  • Создает бронирование в бэк-офисе Maideo (видимое для операционной команды)

  • Регистрирует конечного пользователя в URSSAF для получения 50% аванса налогового вычета (оплата картой не нужна — прямое списание SEPA после каждого визита)

  • Отслеживает статус бронирования

Related MCP server: Sherlock Homes

Доступные инструменты

Инструмент

Назначение

search_coverage

Проверить, обслуживает ли Maideo почтовый индекс

get_quote

Получить твердое ценовое предложение, действительное 72 часа

create_booking

Создать бронирование (возвращает bookingToken, действительный 72 часа)

enroll_avance_immediate

Отправить данные для регистрации в URSSAF (IBAN + личность)

get_booking_status

Получить статус (заказ, исполнитель, URSSAF)

Установка

npm install -g @maideo/mcp
# or use npx without installing:
npx @maideo/mcp

Настройка Claude Desktop

Отредактируйте ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) или %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "maideo": {
      "command": "npx",
      "args": ["-y", "@maideo/mcp"],
      "env": {
        "MAIDEO_AGENT_NAME": "claude-desktop"
      }
    }
  }
}

Перезапустите Claude Desktop. Теперь вы можете попросить Claude:

"Можешь забронировать мне еженедельную 3-часовую уборку по адресу 12 rue de Rivoli, 75001 Paris, начиная со следующего понедельника?"

Claude автоматически объединит 5 инструментов.

Настройка Claude Code

claude mcp add maideo npx -- -y @maideo/mcp

Переменные окружения

Переменная

По умолчанию

Назначение

MAIDEO_API_BASE

https://api.maideo.fr/public/agent

Базовый URL API (переопределите для staging/dev)

MAIDEO_AGENT_NAME

maideo-mcp-client

Идентификатор, отправляемый через заголовок X-Agent-Name (используется для ограничения частоты запросов и аналитики)

Защита от мошенничества

Все бронирования, созданные через этот MCP-сервер, удерживаются в течение 48 часов перед назначением исполнителя. Операционная команда Maideo может позвонить или отправить SMS конечному пользователю для проверки. Не отправляйте бронирования с фиктивными данными в продакшн. Ваш MAIDEO_AGENT_NAME может быть заблокирован.

Вы также должны получить явное согласие от конечного пользователя перед вызовом create_booking. Передайте agentConsent: true в качестве подтверждения согласия.

Как работает оплата (этапа оплаты нет)

Maideo использует систему URSSAF avance immédiate de crédit d'impôt (аванс налогового вычета), государственную программу Франции для бытовых услуг.

  1. Конечный пользователь регистрируется через enroll_avance_immediate — предоставляет личность, место рождения, адрес, IBAN

  2. Исполнитель выполняет уборку

  3. Maideo декларирует часы в URSSAF

  4. URSSAF выплачивает Maideo напрямую 50% от суммы (часть налогового вычета)

  5. URSSAF списывает оставшиеся 50% с конечного пользователя через прямое списание SEPA

Никаких карт, никакого Stripe, никакой предоплаты, никаких подписанных PDF. Достаточно IBAN и данных личности.

Ссылки

Лицензия

MIT

Available Tools

5 tools
create_bookingA

Create a booking. Requires a quoteToken from get_quote plus the end-user's identity, address, and explicit consent. Returns a bookingToken (72h) for subsequent calls and a bookingId. The booking is held for 48h before worker dispatch as anti-fraud protection.

Inputs: quoteToken (required), client (required), address (required), dateDebut (required), +5 more.

enroll_avance_immediateA

Enroll the end user with URSSAF for the 50% immediate tax credit advance. After this succeeds, the user pays only half the gross hourly rate via SEPA. Required: bookingToken from create_booking, full identity, birth place, postal address, IBAN.

Inputs: bookingId (required), bookingToken (required), civilite (required), nomNaissance (required), +8 more.

get_booking_statusA

Poll the current status of a booking (order, mission, worker assignment, URSSAF enrollment). Requires bookingId + bookingToken from create_booking.

Inputs: bookingId (required), bookingToken (required).

get_quoteA

Get a firm price quote for a cleaning booking. Returns a quoteToken valid for 72h that must be passed to create_booking.

Inputs: zip (required), nbHeuresSemaine (required), frequency (required), city, +3 more.

search_coverageA

Check whether Maideo serves a given French postal code and get the estimated hourly rate (gross, before the 50% tax credit advance). Use this BEFORE get_quote.

Inputs: zip (required), prestation.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A4.2/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool has a distinct, non-overlapping purpose: search_coverage checks service availability, get_quote provides pricing, create_booking initiates a booking, enroll_avance_immediate handles tax credit enrollment, and get_booking_status tracks progress. The descriptions clearly differentiate their roles in the booking workflow, leaving no ambiguity for agent selection.

    Naming Consistency4/5

    Four tools follow a consistent verb_noun pattern (create_booking, get_booking_status, get_quote, search_coverage), but enroll_avance_immediate deviates with a mixed verb_noun structure and includes a French term. This minor inconsistency slightly disrupts the pattern but remains readable and understandable.

    Tool Count5/5

    With 5 tools, this server is well-scoped for its domain of booking and managing cleaning services. Each tool serves a specific step in the workflow (coverage check, quoting, booking, enrollment, status tracking), and none feel redundant or missing, making the count appropriate for the purpose.

    Completeness5/5

    The tool set provides complete coverage for the booking lifecycle: search_coverage initiates the process, get_quote handles pricing, create_booking creates the booking, enroll_avance_immediate manages tax credit enrollment, and get_booking_status allows tracking. There are no obvious gaps, and the tools support a seamless workflow from start to finish.

    Maintenance

    ActivitySlowing
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • SF Cleaning Service

      Rana-X
      F
      license
      B
      quality
      Not graded
      maintenance
      Enables booking cleaning services in San Francisco by collecting customer details and automatically sending booking requests via email to service partners.
      1
      -

    • Sherlock Homes

      RomainLaffitau
      F
      license
      Not graded
      quality
      D
      maintenance
      French real estate data platform for AI agents. Identifies property owners likely to sell and tracks behavioral signals on active listings. Coverage: metropolitan France.
      -

    • 11fgb-cleaning-tools-mcp

      kossik
      A
      license
      Not graded
      quality
      D
      maintenance
      Provides deterministic cleaning cost, time, crew, and chemical usage estimates for homes and offices via MCP and HTTP endpoints.
      MIT
    • Normi — French Real Estate Data (DVF)

      Normi — French Real Estateofficial

      NormiHQ
      A
      license
      Not graded
      quality
      C
      maintenance
      Access 17M+ geocoded French property transactions (DVF), 22M+ DPE energy ratings, and 20M+ building records via MCP or REST API. Search transactions, market stats, comparables, price trends, rental yield, flip detection, and more.
      MIT