Skip to content

beel-es/beel-mcp

v0.4.2MIT

Spanish e-invoicing with VeriFactu (AEAT) for AI agents: issue, correct and register invoices, manage customers and NIFs, validate NIFs against the census. Hosted MCP server at https://mcp.beel.es/mcp (Streamable HTTP + OAuth 2.1) or local stdio via npm.

GitHubOpen Website

Changelog

Las entradas las genera release-please a partir de los Conventional Commits fusionados en master.

0.5.0 (2026-08-29)

Novedades

  • discovery: public resources/read and prompts/get, CSP meta in the viewer (#BEE-1443) (#86) (6edf8cd)
  • oauth: advertise scopes_supported and add opt-in public discovery (#BEE-1443) (#84) (3ddaf71)
  • oauth: agent_auth block in the authorization-server metadata (#BEE-1443) (#88) (dc72c12)

Documentación

  • AGENTS.md for coding agents and an Agent Plugins manifest (#BEE-1443) (#87) (2fda2d9)

0.4.2 (2026-08-29)

Correcciones

  • security: errores de autorización como 4xx, TTL en registros DCR, publish solo desde tag y sync-spec por PR (#82) (6353e83)
  • spec: el contrato sincronizado deja de citar los hosts de almacenamiento en sus ejemplos (#83) (195acec)

Documentación

  • community: plantillas de PR e issues, código de conducta y guía para contribuir (#80) (ff82f9a)

0.4.1 (2026-08-29)

Documentación

  • CHANGELOG versionado y badges de CI y releases en el README (#76) (79fcf89)

0.4.0 (2026-08-29)

Novedades

  • Validación de argumentos contra el schema de cada herramienta también en el servidor remoto (Cloudflare Workers).
  • Nombres de herramienta coherentes con el contrato: beel_get_company, beel_patch_company, beel_delete_company, beel_activate_company, beel_deactivate_company, beel_delete_company_logo (antes beel_*_by_id).
  • destructiveHint/idempotentHint derivados del contrato (x-irreversible, verbo HTTP, cabecera Idempotency-Key).
  • Schemas más compactos y estrictos: sin example ni propiedades readOnly, additionalProperties: false.

Correcciones

  • El puente OAuth no reutiliza un estado de autorización; un fallo de refresco obliga a reconsentir; el entorno se lee del token emitido.
  • beel_get_setup_status ya no informa "listo para emitir" cuando una comprobación falló; cada sección expone su error.
  • Idempotency-Key solo en las operaciones que la declaran; los reintentos de mutaciones sin clave se limitan a 429/503.
  • Se retira beel_put_owner: solo está disponible con sesión del dashboard, nunca con credencial de API.