Agent Utilities MCP

Agent Utilities MCP

Conecta un cliente MCP stdio local a 36 API de utilidades de pago para extracción de HTML, validación de JSON, comprobaciones de configuración de agentes y datos de productos. Este adaptador con licencia MIT se ejecuta localmente; la API alojada es un servicio de pago.

Catálogo de herramientas · Guía de instalación · Precios · Políticas y soporte

Usuarios de VS Code: abre el enlace de configuración y la configuración de la clave privada. Instrucciones detalladas están incluidas en este repositorio fuente.

Prueba el ejemplo de compra sin una cuenta

Clona este repositorio y previsualiza el carrito proporcionado con Node.js 22+:

cd examples/cart
shasum -a 256 -c cart-workflow.mjs.sha256
node cart-workflow.mjs --preview cart-example.json

La previsualización valida la entrada e imprime el plan de tres pasos sin conexión, sin clave de API, solicitud de red ni cargo. No ejecuta las herramientas. La salida esperada incluida es un fixture local: las cadenas de precios en alemán se convierten en montos decimales, los parches protegidos actualizan la instantánea del carrito proporcionado, y la conciliación de costos devuelve un total conocido de €45.92. El impuesto es desconocido, por lo que el total final permanece como null.

Para ejecutar esas tres operaciones contra el servicio alojado, configura de forma privada AGENT_UTILITIES_API_KEY en el entorno de tu proceso y elige explícitamente:

node cart-workflow.mjs --execute cart-example.json

La ejecución gasta créditos de servicio existentes. La receta impone límites de precio por llamada que suman como máximo $0.0013 (0.13 centavos) en sus tres llamadas lógicas. Se detiene si un precio descubierto es demasiado alto o si un precio posterior excede el límite autorizado. Los pasos completados permanecen cobrados si un paso posterior falla. Cada paso devuelve su recibo de débito e información de recuperación; no vuelvas a ejecutar toda la receta después de una respuesta incierta. Lee las instrucciones de la receta antes de ejecutar. Este ejemplo no compra créditos ni realiza un pedido de comerciante.

La receta es una descarga independiente separada, no parte del paquete MCPB inmutable v0.3.0. También puedes obtenerla desde la página de flujo de trabajo. El comportamiento de gasto del adaptador MCP genérico permanece como se describe a continuación.

Lee el material directamente desde un agente

No se necesita cuenta ni clave para leer contratos, ejemplos, precios y guías:

curl --fail --silent --show-error \
  https://agent-utilities.agent-utilities.workers.dev/v1/content/index

• Contenido JSON completo: esquemas de entrada/salida de herramientas, solicitudes de ejemplo, encabezados de ejecución, flujos de trabajo y documentación.
• Guía de texto completo: el mismo material como texto plano.
• Contrato de una herramienta: esquema de solicitud, ejemplo, precio y URL de ejecución.
• Flujo de trabajo de carrito: los pasos y el precio agregado actual.
• OpenAPI: operaciones de herramientas HTTP, encabezado opcional de límite de crédito y respuestas de error.

Estos endpoints GET públicos admiten lecturas de navegador de origen cruzado. La ejecución de herramientas sigue siendo de pago. Los clientes HTTP personalizados pueden enviar X-Max-Credit-Micro-Usd para limitar un nuevo débito de crédito prepagado; lee la guía de inicio rápido para conocer la semántica de reintentos. El adaptador 0.3.0 limita cada nueva llamada al precio del catálogo de inicio y requiere soporte anunciado por el servidor.

¿Prefieres Python?

El cliente HTTP de Python usa solo bibliotecas estándar de Python 3.10+. Consulta examples/python para previsualización sin conexión, descubrimiento gratuito y llamadas de pago explícitas con límites por llamada e identidades de reintento estables. No se requiere Node ni un proceso MCP para esta ruta. Es independiente del paquete MCPB.

Instalación

También está listado en Smithery como un paquete MCPB local de Node.js. Su descarga coincide con el artefacto de GitHub v0.3.0. Conecta el adaptador para obtener los esquemas y precios completos actuales de las herramientas; los metadatos del directorio son un resumen de descubrimiento.

Para clientes que admiten paquetes MCPB, descarga agent-utilities-mcp-0.3.0.mcpb y su suma de verificación desde la versión v0.3.0. Verifica la suma de verificación antes de importar el paquete a través de la configuración de extensiones de tu cliente. Contiene el adaptador, el manifiesto y los avisos de licencia. El paquete no está firmado; la suma de verificación de la versión establece la consistencia del archivo, no una firma independiente. El esquema del paquete y la ejecución independiente están probados; la instalación en cada cliente de escritorio no está verificada.

La configuración opcional de clave de API de Agent Utilities del paquete está marcada como sensible. Déjala vacía para descubrimiento gratuito, o ingresa solo tu clave de API para habilitar llamadas de pago. Se requiere Node.js 22+; usa un runtime compatible proporcionado por tu cliente o instalado localmente. Si tu cliente no puede importar archivos MCPB, usa la configuración manual a continuación.

Requiere Node.js 22 o más reciente. Descarga agent-utilities-mcp.mjs y su archivo .sha256 desde la guía de instalación, luego verifica el archivo desde su carpeta:

shasum -a 256 -c agent-utilities-mcp.mjs.sha256

Alternativamente, clona este repositorio y usa su agent-utilities-mcp.mjs incluido directamente. No se necesita npm install para ejecutar el paquete. El código fuente está en src/; npm ci && npm run build lo reconstruye. El paquete público se prueba como un proceso independiente fuera del árbol de dependencias de la aplicación.

Para un cliente que usa el formato de configuración común mcpServers:

{
  "mcpServers": {
    "agent-utilities": {
      "command": "node",
      "args": ["/absolute/path/agent-utilities-mcp.mjs"],
      "env": {
        "AGENT_UTILITIES_API_KEY": "YOUR_PRIVATE_API_KEY"
      }
    }
  }
}

Reemplaza la ruta del archivo. Configura la clave de API de forma privada usando la configuración secreta del cliente donde se admita; nunca confirmes una clave real ni la pegues en un prompt de agente. Usa la ruta absoluta a Node si el cliente no puede encontrarlo. Los clientes MCP solo remotos no pueden iniciar este adaptador stdio.

Omite la clave para descubrir herramientas sin gastar créditos. Obtén una clave de API y una clave de recuperación guardada por separado en el espacio de trabajo. Solo dale la clave de API al adaptador. El modo en vivo vende $5 USD en créditos de servicio prepagados. Verifica el modo mostrado antes de comprar.

Qué hace

• Obtiene las definiciones públicas de herramientas y los precios actuales por llamada al inicio.
• Expone las 36 herramientas de servicio y un asistente de recuperación. El asistente de recuperación no es un producto adicional.
• Envía llamadas autenticadas solo al origen fijo de Agent Utilities; se rechazan redirecciones.
• Genera un ID de solicitud de débito estable y reintenta un intercambio HTTP fallido con el mismo cuerpo e ID.
• Mantiene identidades de solicitud y hashes de entrada en memoria del proceso, sin registrar entradas, resultados ni credenciales. El manejo de datos remotos se describe en las políticas del servicio.
• No compra créditos, no recarga automáticamente, no accede a una billetera ni acepta credenciales de recuperación.

Prueba una tarea útil como: "Usa commerce_gtin_validate para verificar el código de barras 036000291452." Una llamada exitosa cuesta $0.0003. Los precios actuales de las herramientas van de $0.0003 a $0.002; son precios experimentales, no fijos para siempre. Cada nueva operación gasta créditos. La versión 0.3.0 limita cada nuevo débito al precio descubierto al inicio. No hay presupuesto total de sesión; las llamadas nuevas repetidas pueden gastar el saldo disponible. Un precio de servidor más alto devuelve HTTP 412 en lugar de aumentar el límite. Reinicia solo después de revisar los precios actualizados. Revisa los precios y aprueba el gasto en tu cliente.

Reintenta un resultado incierto

Los resultados y resultados inciertos incluyen un requestId. Llama a agent_utilities_retry con ese ID, el nombre original de la herramienta MCP y los argumentos originales:

{
  "requestId": "COPY_THE_RETURNED_REQUEST_ID",
  "name": "commerce_gtin_validate",
  "arguments": { "code": "036000291452" }
}

Dentro de diez minutos, una solicitud completada devuelve el resultado guardado sin otro débito. En la versión 0.3.0, el asistente de recuperación envía un límite cero: una solicitud que nunca llegó al servicio se rechaza sin una nueva reserva. Esto no cancela una reserva anterior ni reembolsa un cargo. El reintento automático de transporte de una nueva llamada conserva su límite original distinto de cero y aún puede ejecutar esa operación autorizada una vez. No generes un nuevo ID ni cambies la entrada para recuperar un resultado incierto. Las identidades de solicitud expiradas no pueden hacer otro débito. Reutilizar un ID de solicitud MCP dentro de un proceso también conserva su identidad de débito original.

Después de un reinicio del proceso, necesitas el ID de solicitud devuelto y la entrada original para la recuperación. Si el proceso murió antes de que tu cliente recibiera el ID, inspecciona el saldo o contacta al soporte antes de repetir la operación. No se almacena un historial local duradero de entradas o resultados. Cada proceso retiene hasta 5,000 identidades de solicitud MCP, luego rechaza nuevas llamadas hasta que se reinicie; completa primero la recuperación pendiente.

Límites del servicio

La versión permite 1,000 llamadas de pago nuevas por día en todo el servicio. Las entradas están limitadas a 128 KiB incluida la sobrecarga del protocolo. Las herramientas de red están restringidas a los hosts mostrados en el catálogo; no son un navegador web general. Las comprobaciones de seguridad son heurísticas. Los resultados exitosos se cifran para recuperación de reintento de diez minutos, con tombstones de solicitud retenidos por un día. Consulta las políticas para detalles de retención y reembolsos.

Las pruebas automatizadas verifican la recuperación de respuesta perdida contra un libro mayor de crédito local de Cloudflare. No establecen demanda del cliente ni prueban una compra real de cliente. La validación de directorio y el descubrimiento gratuito de herramientas no son ventas.

Licencia

Código del adaptador: MIT. Dependencias incluidas: consulta THIRD-PARTY-NOTICES.txt. La licencia cubre el adaptador, no el acceso gratuito a las APIs alojadas.

Elige paquetes completos para una tarea de compra

El planificador de paquetes encuentra el subtotal mínimo de artículos para una cantidad requerida de artículos intercambiables usando límites de paquete explícitos. Doce artículos pueden costar $15.98 como dos paquetes de seis a $7.99, incluso cuando un paquete de diez a $11.99 tiene un precio unitario más bajo. La operación cuesta $0.0008 en créditos prepagados. Envío, impuestos, cupones y equivalencia de productos están fuera de su optimización.

Llama a commerce_pack_plan a través de MCP, o usa el cliente de Python con el ID de herramienta commerce.pack-plan y un límite explícito de 800 micro-dólares. Inspecciona el contrato JSON gratuito antes de ejecutar. El flujo de trabajo trabajado explica los límites de stock y cómo los conteos de paquetes se mapean en la conciliación del carrito. El adaptador descubre esta herramienta desde el servicio; las herramientas nuevas no requieren reemplazar el adaptador.

Prueba el ejemplo de planificación de paquetes en Python con sus tres casos de muestra. Ejecuta python3 pack_plan_example.py desde examples/python, o selecciona --scenario limited-stock / --scenario insufficient-stock. El valor predeterminado es una visualización sin conexión de fixtures fijos; no envía solicitud ni calcula una nueva respuesta. Agregar --execute autoriza explícitamente una llamada alojada limitada a $0.0008 usando créditos existentes. Un resultado inviable válido también es facturable. Consulta la guía de Python para sumas de verificación, límites de entrada y recuperación antes de ejecutar. Cada nueva ejecución crea un nuevo ID; no vuelvas a ejecutar para recuperar un resultado de pago incierto.

Actualización desde 0.2.1

Instala 0.3.0 para límites de precio por llamada y reintentos manuales solo de recuperación. La versión 0.2.1 no aplica estas protecciones del adaptador. Los bytes de la versión 0.2.1 existente permanecen disponibles y sin cambios; actualizar requiere reemplazar el adaptador instalado. El límite por llamada no limita el número de llamadas nuevas ni proporciona un presupuesto total de sesión.

Compara totales de checkout entregados

La receta de Python de biblioteca estándar en examples/python/compare_carts.py compara instantáneas de checkout de comerciante proporcionadas usando una conciliación limitada por carrito. La previsualización predeterminada es sin conexión; la ejecución requiere --execute y créditos existentes. Clasifica totales completos, conserva empates y se niega a nombrar un ganador general cuando cualquier carrito tiene envío, impuestos o tarifas desconocidos. El límite predeterminado de dos carritos es $0.001. Consulta la guía de comparación para entradas de muestra, sumas de verificación, presupuestos explícitos y recuperación.