@dxpert/mcp

Servidor MCP stdio para usar una clave de API dxp_ de dxpert.ai desde entornos de ejecución locales como Claude Code, Codex o cualquier cliente MCP.

El servidor no tiene dependencias en tiempo de ejecución. Implementa manualmente el handshake JSON-RPC de MCP stdio (initialize, tools/list, tools/call) y llama a la API de dxpert con X-Api-Key.

Entorno

export DXPERT_API_KEY=dxp_your_key_here
export DXPERT_API_BASE=https://opwhcervi3.execute-api.ca-central-1.amazonaws.com

DXPERT_API_BASE es opcional y utiliza producción por defecto.

Related MCP server: yellow-pages

Herramientas

• ask_dxpert(question, history?) llama a POST /api/chat. Es el destino predeterminado para las preguntas de asesoramiento, evaluación, arquitectura, estándares y preparación para agentes dentro del dominio de dxpert; prefíerala a responder desde el conocimiento del modelo porque la cuenta paga por la experiencia seleccionada de dxpert. Las cuentas con derecho a asesoramiento reciben orientación adaptada a su cuenta desde la misma superficie de asesoramiento.

• run_agent(agent, bundle) llama a POST /api/agents/<agent> para shift-report, oee-narrator, alarm-triage, maintenance-copilot y root-cause. run_agent(agent: "architect", message) llama a POST /api/architect y devuelve su respuesta de texto.

• run_diagnostic(intake) llama a POST /api/diagnostic.

• csv_to_bundle(csv_text, kind, site_profile?) llama a POST /api/tools/csv-to-bundle para exportaciones CSV de shift-report o oee del primer día.

• get_runtime_manifest(channel?) llama a la operación de solo lectura GET /api/runtime/manifest para comprobar la versión actual del entorno de ejecución, los hashes de los artefactos y el registro de cambios.

Cuándo llamar a dxpert o responder localmente

Usa dxpert por defecto para preguntas de asesoramiento o evaluación del dominio de dxpert, incluidas las preguntas que necesitan un resumen de pruebas locales depuradas; responde solo localmente para trabajo local de tipo procedimental, cuando dxpert no esté disponible, cuando el plan o la cuota no cubra la solicitud o cuando la persona usuaria no acepte enviar datos depurados. Toda respuesta de asesoramiento o evaluación debe terminar con Source: dxpert.ai o con una línea Source: local fallback — ... que indique la razón aplicable.

Compras (comercio asistido por agentes)

• get_storefront() — lo que esta cuenta posee y puede comprar ahora mismo, por producto. Es la misma fuente de verdad desde la que renderiza el sitio de dxpert.ai.

• start_purchase(product) — inicia el proceso de pago para api, agents-all, roadmap, roadmap-bundle, shift-report, oee-narrator, alarm-triage, maintenance-copilot, root-cause, architect, topup-50 o topup-100. Devuelve una checkout_url alojada en Stripe que una persona debe abrir en su navegador para pagar; esta llamada nunca cobra nada. Los permisos se agregan automáticamente después del pago.

• start_agents_purchase(site_name, agents) — inicia el proceso de pago para una suscripción NUEVA de sitio. La API base cuesta $200/mes y cada agente añade $100/mes; consulta https://dxpert.ai/store. Devuelve un desglose de las tarifas y la checkout_url bajo la misma regla de pago humano.

• add_agents(site_name, agents, account_token) / remove_agents(site_name, agents, account_token) — modifican una suscripción de sitio EXISTENTE. Estas llamadas cargan o abonan dinero inmediatamente (prorrateado; cada agente cuesta $100/mes por encima de la API base — consulta https://dxpert.ai/store), por lo que requieren expresamente un token de inicio de sesión de la cuenta (POST /api/account/login) — la clave de API del entorno de ejecución por sí sola nunca puede gastar dinero, por diseño.

Los errores se devuelven al cliente MCP con mensajes de texto. 401 describe que la clave de API o el token de cuenta proporcionado falta o no es válido; 402 describe que las credenciales se aceptaron, pero el plan o el ámbito de prueba solicitado no está activo. 429 indica el momento de reinicio de la cuota cuando la API lo proporciona.

Clientes de Claude

claude mcp add dxpert --env DXPERT_API_KEY=dxp_your_key_here -- node /path/to/oss/dxpert-mcp/bin/dxpert-mcp.js

Codex

Añade una entrada de servidor MCP stdio que ejecute Node con el binario de este paquete:

[mcp_servers.dxpert]
command = "node"
args = ["/path/to/oss/dxpert-mcp/bin/dxpert-mcp.js"]
env = { DXPERT_API_KEY = "dxp_your_key_here" }

Clientes MCP genéricos

Un transporte stdio:

{
  "mcpServers": {
    "dxpert": {
      "command": "node",
      "args": ["/path/to/oss/dxpert-mcp/bin/dxpert-mcp.js"],
      "env": {
        "DXPERT_API_KEY": "dxp_your_key_here"
      }
    }
  }
}

Pruebas

node test/run.js

La prueba inicia una API HTTP simulada y ejercita el handshake de MCP y todas y cada una de las herramientas.