---
title: "Referencia de herramientas del MCP de Payhawk - Payhawk Help Center"
slug: "payhawk-mcp-tool-reference"
description: "Consulta qué herramientas usa el MCP de Payhawk, cómo difieren las de lectura de las de escritura que piden tu confirmación y cuáles ayudan con tus preguntas."
updated: 2026-10-23T10:37:51Z
published: 2026-10-23T10:37:51Z
canonical: "payhawk.com/payhawk-mcp-tool-reference"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://payhawk.com/help/llms.txt
> Use this file to discover all available pages before exploring further.

# Referencia de herramientas del MCP de Payhawk

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.

> [!TIP]
> 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](/help/payhawk-mcp-tool-reference#full-list-of-supported-payhawk-mcp-tools).

| 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` |