Desarrolladores
Qué puede llamar un asistente conectado a tu cuenta, con el permiso y el tipo de acceso de cada herramienta.
El servidor MCP ofrece 55 herramientas en 9 áreas: 27 de solo lectura y 28 que modifican datos. Para conectar un cliente, mira Servidor MCP.
| Herramienta | Qué hace | Acceso | Permiso |
|---|---|---|---|
contacts_list | Busca y lista contactos por nombre, correo o NIF, con paginación. | Solo lectura | contacts:contacts.read |
contacts_create | Crea un contacto. Si ya existe (por NIF, correo o teléfono), devuelve el existente en lugar de duplicarlo. | Modifica datos | contacts:contacts.create |
| Herramienta | Qué hace | Acceso | Permiso |
|---|---|---|---|
billing_list | Lista documentos de venta: facturas, proformas y otros. | Solo lectura | sales:invoices.read |
billing_record_payment | Registra un cobro recibido fuera de la plataforma sobre una factura. | Modifica datos Acción crítica | sales:invoices.pay |
billing_get | Consulta un documento de venta con sus líneas, impuestos y cobros. | Solo lectura | sales:invoices.read |
billing_convert | Convierte un documento en factura borrador, igual que el botón «Convertir a factura» del área de cliente. | Modifica datos | sales:invoices.create |
billing_finalize | Emite un borrador como factura, con numeración fiscal correlativa. | Modifica datos Acción crítica | sales:invoices.issue |
billing_update_draft | Modifica un borrador de venta. Una factura ya emitida no se edita: se rectifica. | Modifica datos | sales:invoices.update |
issuer_profiles_list | Lista los perfiles de emisión de facturas de una sociedad. | Solo lectura | sales:issuer_profiles.read |
issuer_profiles_create | Crea un perfil de emisión con su serie de numeración. | Modifica datos | sales:issuer_profiles.create |
issuer_profiles_update | Modifica parcialmente un perfil de emisión. | Modifica datos | sales:issuer_profiles.update |
billing_import_historical | Carga facturas ya emitidas y contabilizadas fuera de la plataforma, sin duplicar las existentes. | Modifica datos Acción crítica | sales:invoices.import |
| Herramienta | Qué hace | Acceso | Permiso |
|---|---|---|---|
suppliers_import_historical | Carga facturas recibidas ya contabilizadas fuera de la plataforma, sin duplicar las existentes. | Modifica datos Acción crítica | purchases:documents.import |
| Herramienta | Qué hace | Acceso | Permiso |
|---|---|---|---|
books_journal_batch | Registra asientos de partida doble por lotes (hasta 500). Todo o nada. | Modifica datos | accounting:journal.create |
books_accounts_upsert | Crea o actualiza cuentas del catálogo contable por lotes (hasta 2.000). | Modifica datos | accounting:ledger_accounts.update |
books_fixed_assets_list | Lista los activos fijos de una sociedad. | Solo lectura | accounting:fixed_assets.read |
books_fixed_assets_create | Da de alta un activo fijo. Es idempotente. | Modifica datos | accounting:fixed_assets.create |
books_fiscal_years_list | Lista los ejercicios contables de una sociedad. | Solo lectura | accounting:fiscal_years.read |
books_fiscal_years_create | Crea ejercicios contables con sus periodos. Es idempotente. | Modifica datos | accounting:fiscal_years.create |
| Herramienta | Qué hace | Acceso | Permiso |
|---|---|---|---|
compliance_matrix | Matriz de modelos por periodo: lo que corresponde según el perfil fiscal y lo ya presentado. | Solo lectura | tax:obligations.read |
compliance_overview | Resumen del cumplimiento fiscal por sociedad. | Solo lectura | tax:obligations.read |
fiscal_position | Posición fiscal del ejercicio calculada desde el diario: IVA por trimestre y retenciones. | Solo lectura | tax:returns.read |
fiscal_justificante_url | Devuelve la dirección de descarga del justificante de una declaración presentada. | Solo lectura | tax:returns.read |
fiscal_profile_get | Consulta el perfil fiscal de una sociedad. | Solo lectura | tax:profile.read |
fiscal_profile_update | Crea o actualiza el perfil fiscal: domicilio, actividad, representante y regímenes de IVA e IS. | Modifica datos | tax:profile.update |
| Herramienta | Qué hace | Acceso | Permiso |
|---|---|---|---|
laboral_workers_list | Lista los trabajadores de una sociedad con sus datos de Seguridad Social. | Solo lectura | payroll:workers.read |
laboral_workers_upsert | Da de alta o actualiza trabajadores por lotes (hasta 500), por sociedad y DNI. | Modifica datos | payroll:workers.create |
| Herramienta | Qué hace | Acceso | Permiso |
|---|---|---|---|
sign_envelope_create | Crea un sobre de firma en borrador. | Modifica datos | sign:envelopes.create |
sign_document_upload | Adjunta un PDF (en base64) a un sobre en borrador. | Modifica datos | sign:envelopes.update |
sign_participant_add | Añade un firmante o aprobador a un sobre en borrador. | Modifica datos | sign:envelopes.update |
sign_field_place | Coloca un campo (firma, iniciales, texto, casilla o fecha) en unas coordenadas exactas del documento. | Modifica datos | sign:envelopes.update |
sign_envelope_send | Envía el sobre: pasa de borrador a activo e invita a los participantes por correo. | Modifica datos Acción crítica | sign:envelopes.send |
sign_envelope_status | Estado completo de un sobre: ciclo de vida y estado de cada participante. | Solo lectura | sign:envelopes.read |
sign_envelopes_list | Lista sobres con paginación, con filtro opcional por estado. | Solo lectura | sign:envelopes.read |
sign_envelope_void | Cancela un sobre activo y avisa a los participantes. | Modifica datos Acción crítica | sign:envelopes.void |
sign_envelope_reissue | Crea un sobre nuevo a partir de uno anulado o caducado, conservando participantes y documentos. | Modifica datos Acción crítica | sign:envelopes.reissue |
sign_pdf_download | Descarga el PDF de un documento del sobre, en base64. | Solo lectura | sign:evidence.read |
sign_evidence_download | Descarga el paquete de evidencias del sobre: PDF firmado y trazas de cada participante. | Solo lectura | sign:evidence.read |
sign_verify | Verifica un documento firmado a partir del código impreso en él. | Solo lectura | sign:verification.read |
notify_certified | Envía un correo o SMS certificado y devuelve el paquete de evidencias sellado. | Modifica datos Acción crítica | sign:certified_mail.send |
sign_envelope_pause_reminders | Pausa los recordatorios diarios de un sobre hasta una fecha. | Modifica datos | sign:envelopes.update |
sign_envelope_by_token | Consulta un sobre a partir del enlace o token de firma. | Solo lectura | sign:envelopes.read |
| Herramienta | Qué hace | Acceso | Permiso |
|---|---|---|---|
dgt_get | Consulta íntegra de una consulta vinculante de la DGT por su identificador (por ejemplo V2318-25). | Solo lectura | knowledge:dgt.read |
dgt_search | Busca en el corpus de consultas vinculantes de la DGT con filtros. | Solo lectura | knowledge:dgt.read |
dgt_by_topic | Lista las consultas vinculantes de la DGT etiquetadas con un tema. | Solo lectura | knowledge:dgt.read |
dgt_evolution | Análisis de cómo ha evolucionado el criterio de la DGT sobre un tema. | Solo lectura | knowledge:dgt.read |
dgt_stats | Estadísticas del corpus de la DGT y fecha hasta la que está al día. | Solo lectura | knowledge:dgt.read |
search_query | Búsqueda híbrida (por palabras y por significado) en documentos, expedientes, correos y contactos. | Solo lectura | knowledge:search.read |
| Herramienta | Qué hace | Acceso | Permiso |
|---|---|---|---|
tokens_list | Lista las credenciales de la cuenta. | Solo lectura | developers:tokens.read |
tokens_get | Consulta una credencial: permisos, cuenta, IPs permitidas, límites y caducidad. | Solo lectura | developers:tokens.read |
tokens_create | Crea una credencial para la cuenta. | Modifica datos | developers:tokens.create |
tokens_update | Modifica una credencial: nombre, permisos, IPs, límites o caducidad. | Modifica datos | developers:tokens.update |
tokens_rotate | Genera un valor nuevo para una credencial; el anterior deja de servir. | Modifica datos Acción crítica | developers:tokens.rotate |
tokens_revoke | Revoca una credencial de forma definitiva. | Modifica datos | developers:tokens.delete |
api_usage_get | Consulta el uso de la API: llamadas por ventana de tiempo o el mes en curso. | Solo lectura | developers:usage.read |