Referencia de herramientas del MCP de Payhawk

Prev Next

En segundo plano, el MCP de Payhawk expone un conjunto de herramientas estructuradas y organizadas por áreas. La lista de herramientas que verás se filtra según tu rol y la configuración de tu cuenta.

Cada herramienta es de uno de estos dos tipos:

  • Read: estas herramientas consultan y devuelven información (por ejemplo, obtener un gasto o listar tus tarjetas). Nunca modifican nada y se ajustan automáticamente a tus permisos.

  • Write: estas herramientas actúan en tu nombre para realizar un cambio (por ejemplo, actualizar el campo de categoría de un gasto). Siempre muestran una vista previa y requieren tu confirmación.

El Asistente de IA selecciona automáticamente la herramienta adecuada y nunca tienes que llamarla por su nombre. Esta referencia de herramientas del MCP de Payhawk está dirigida a los responsables de TI y seguridad, así como a quienes sientan curiosidad por los aspectos técnicos.

Herramientas prácticas que conviene conocer

Las siguientes herramientas hacen algo realmente útil que vale la pena tener presente. También aparecen en la lista completa de herramientas del MCP de Payhawk.

Herramienta

Qué hace

A quién va dirigida

Cuándo usarla y cuándo no

submit_feedback

Envía tus comentarios sobre la experiencia con el asistente de Payhawk a Payhawk, con tus propias palabras, con una sola confirmación y sin formularios.

Cualquier persona que use el asistente - un elogio, una frustración, una sugerencia o la queja por un error: cualquier reacción a la propia experiencia del MCP.

Úsala: En cuanto expresas una opinión sobre la experiencia, el asistente ofrece, en una frase breve, enviarla.
No la uses para: Preguntas sobre el producto o solicitudes de soporte (una vía distinta) - esto son comentarios sobre el MCP, no un ticket.

product_help

Responde preguntas del tipo «Cómo hago…» y «Está X disponible para nosotros» sobre Payhawk, adaptadas a lo que tu cuenta tiene realmente activado y basadas en artículos de ayuda que puede citar.

Todos. Especialmente cualquiera que, de otro modo, abriría un ticket de soporte por algo que responde un artículo: un empleado atascado en un envío o un Administrador de Payhawk que comprueba si una función está incluida en su plan.

Úsala: Preguntas sobre el producto. Cómo funciona algo, si dispones de ello, cómo activarlo.

No la uses para: Diagnosticar un pago, transacción o reembolso concreto de tu propia cuenta (requiere la vía de datos en tiempo real), o enviar comentarios sobre el asistente (su propio canal).

list_card_acceptance_opportunities

Enumera los proveedores a los que pagas por transferencia bancaria y que se sabe que aceptan pagos con tarjeta, junto con el gasto bancario que podría trasladarse a una tarjeta Payhawk para obtener recompensas.

Controllers financieros y administradores de finanzas que buscan recompensas sobre un gasto que la empresa ya realiza. Esta es la herramienta detrás de la pregunta sobre el cashback.

Úsala: «¿Qué proveedores podríamos pagar con tarjeta en su lugar?»

No la uses para: cambiar un método de pago (se hace en los ajustes de facturación de cada proveedor, nunca en Payhawk); nunca te indicará un importe de cashback, porque las tasas de recompensa no son datos de Payhawk.

needs_my_attention

Tu bandeja de entrada de Payhawk en una sola llamada: todo lo que está pendiente de ti, como aprobaciones pendientes, solicitudes, tareas y recibos que faltan, además de señales de finanzas y administración cuando tu rol las incluye.

Todos, con contenido según el rol: los empleados ven sus propios elementos y los pagos con tarjeta fallidos; el equipo de finanzas ve el número de elementos sin codificar y sin exportar; los Administradores de Payhawk ven las señales de tarjetas.

Úsala: cualquier momento de «¿Qué requiere mi atención?», desde una puesta al día matinal hasta un repaso antes de las vacaciones.

No la uses para: un simple recuento de aprobaciones pendientes (existe un resumen más ligero); muestra algunos elementos sobre los que no puede actuar (por ejemplo, revisiones de viajes o aprobaciones de doble verificación), que señala a la aplicación.

insights_query_async

Análisis a lo largo del tiempo - totales y desgloses por empresa/cuenta/equipo/persona. Las tendencias mensuales de saldo disponible usan una única instantánea de cierre por saldo y mes, nunca una suma de instantáneas repetidas.

—

—

Lista completa de herramientas compatibles

La siguiente tabla enumera el conjunto completo de herramientas compatibles como parte del MCP de Payhawk.

Área

Herramientas

Gastos y documentos

list_expenses, get_expense, get_expense_approval_status, list_expense_payments, list_documents, upload_document, ingest_and_auto_match_receipt, create_expense, get_invoice_inbox, submit_expense, recode_expense, list_close_blockers, list_expense_reports, get_expense_report, list_expense_subscriptions, confirm_expense_subscription, manage_expense_subscription, list_mileage_claims

Tarjetas, fondos y transacciones

list_cards, get_card, update_card_status (congelar, descongelar, cerrar), list_card_requests, get_card_request, create_card_request, list_fund_accounts, get_fund_account, list_balances, list_fund_account_activity, get_upcoming_payments, get_transaction, get_fx_rate

Aprobaciones y revisión

review_queue, needs_my_attention, get_approval_request, approve_or_return, complete_expense_review, return_expense_for_review, list_audit_logs, out_of_office_delegate

Proveedores, órdenes de compra y comercios

list_suppliers, get_supplier, manage_supplier, list_purchase_orders, get_purchase_order, manage_purchase_order, list_purchase_order_types, list_merchants, get_merchant, list_card_acceptance_opportunities

Contabilidad, exportación y presupuestos

list_export_history, list_failed_exports, list_export_templates, run_export, list_account_codes, list_tax_rates, list_custom_fields, list_expense_categories, get_expense_category, budgets

Personas, equipos y políticas

list_accounts, list_users, get_user, list_teams, list_team_members, list_spend_policies, get_spend_policy, manage_spend_policy

Comentarios

add_comment, list_comments

Agentes y análisis de Payhawk

insights_query_async, get_job_status (comprueba el estado de las tareas en segundo plano), travel_agent, procurement_agent, payments_agent, dispatch_widget_action (se usa solo cuando haces clic en un botón dentro de una tarjeta interactiva, por ejemplo para elegir un vuelo), get_agent_job_status (comprueba el estado de las tareas de agente y de continuación de widget)

Opiniones

submit_feedback

Orientación

product_help, list_playbooks, get_playbook, draft_playbook, manage_playbook