Tupana

io.github.tupana-aiPublished by GitHub account tupana-aiv0.1.1Updated Oct 30, 2026

Facturación electrónica chilena (SII), cobranza, conciliación bancaria y reportes de ventas.

VerifiedStreamable HTTPWeb executableFinanceDeveloper ToolsBusiness & Commerce

Overview

AI-generated overview

Remote Tupana MCP server that lets an assistant draft and issue Chilean electronic invoices (SII), track collections, reconcile bank movements and pull sales…

What you can do
  • Query, search and preview tax documents, and create drafts for invoices, receipts, credit and debit notes, dispatch guides and scheduled invoices
  • Issue reviewed drafts to the SII, email issued documents and parse spreadsheets or purchase orders into invoice drafts
  • Look up companies, clients, suppliers and SII taxpayer data, plus client and product rankings
  • Produce sales, SII book, F29 and VAT summaries and monthly revenue series
  • List pending invoices, bank movements and reconciliation suggestions, and reconcile movements
  • Prepare, execute and check invoice cession (factoring), and search the public SII company registry for prospects and market size
When to use it
Useful for Chilean businesses and their accountants or sales teams that want an assistant to handle invoicing, collections, bank reconciliation and tax reporting inside Tupana, or for developers adding SII electronic invoicing to a SaaS.
Requirements
A remote Streamable HTTP endpoint with OAuth 2.1 (PKCE, dynamic client registration); the client opens a browser for Tupana login, so no API key is copied. A Tupana account with access to the relevant companies is required, and the client must support remote MCP with OAuth (or a stdio bridge).
Before you install
The server can issue documents to the SII, send emails, reconcile movements and execute invoice cessions; these are described as requiring confirmation, with issuance only after a PDF preview is approved, but the write scope tupana:write is granted at authorization. Issued tax documents and cessions are legally and financially consequential, so review previews carefully. Data is scoped to the companies the signed-in user can access.

Installation

In SourceWeft

  1. Open Tupana in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.tupana-ai%2Ftupana/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

{
  "mcpServers": {
    "tupana": {
      "type": "http",
      "url": "https://mcp.tupana.ai/mcp"
    }
  }
}

README

Tupana MCP

Servidor MCP remoto de Tupana: conecta Claude, ChatGPT, Cursor o cualquier agente compatible con tu facturación electrónica chilena (SII), cobranza, conciliación bancaria y reportes de ventas.

https://mcp.tupana.ai/mcp
  • Transporte: Streamable HTTP.
  • Autenticación: OAuth 2.1 con PKCE y registro dinámico de clientes. Al conectar, el cliente te abre el navegador para que inicies sesión en Tupana y autorices el acceso. No necesitas copiar ninguna API key.
  • Scopes: tupana:read y tupana:write.
  • Privacidad: cada usuario ve solo las empresas a las que tiene acceso en Tupana; todas las herramientas resuelven documentos y empresas dentro de ese alcance.
  • Seguridad: las acciones irreversibles (emitir al SII, enviar correos, conciliar) están diseñadas para pedir confirmación. La emisión es un paso separado: el agente crea un borrador, te muestra la vista previa en PDF y solo emite con emit_document después de tu visto bueno.

¿Aún no tienes cuenta? Créala en developers.tupana.ai.

Qué puedes pedirle

  • "¿Cuánto facturé este mes y quiénes son mis 10 mayores clientes?"
  • "Hazle una factura a 76.123.456-7 por 3 horas de asesoría a $45.000 + IVA, con referencia a la OC 4500123."
  • "¿Qué facturas tengo pendientes de cobro con más de 30 días?"
  • "Concilia los movimientos del banco de ayer con las facturas que calcen."
  • "Muéstrame el resumen de IVA y el F29 de septiembre."
  • "Agrégale facturación electrónica chilena a este SaaS." (el MCP también enseña a construir la integración)

Conectar

Claude (claude.ai y Claude Desktop)

  1. Ve a Settings → Connectors → Add custom connector.
  2. Nombre: Tupana. URL: https://mcp.tupana.ai/mcp.
  3. Haz clic en Connect, inicia sesión en Tupana y autoriza.

En planes Team y Enterprise, un administrador puede agregar el conector para toda la organización.

Claude Code

bash
claude mcp add --transport http tupana https://mcp.tupana.ai/mcp

Luego, dentro de Claude Code, ejecuta /mcp, elige tupana y completa el login en el navegador. Para compartirlo con tu equipo, agrégalo con --scope project (queda en .mcp.json).

Cursor

En ~/.cursor/mcp.json (global) o .cursor/mcp.json (proyecto):

json
{  "mcpServers": {    "tupana": {      "url": "https://mcp.tupana.ai/mcp"    }  }}

Cursor detecta que el servidor pide OAuth y te muestra el botón para iniciar sesión.

ChatGPT

  1. Activa Settings → Apps & Connectors → Advanced settings → Developer mode (disponible según tu plan).
  2. En Apps & Connectors, crea un conector nuevo con la URL https://mcp.tupana.ai/mcp y autenticación OAuth.
  3. Autoriza con tu cuenta de Tupana y actívalo en el chat.

VS Code (GitHub Copilot)

En .vscode/mcp.json:

json
{  "servers": {    "tupana": {      "type": "http",      "url": "https://mcp.tupana.ai/mcp"    }  }}

Otros clientes

Cualquier cliente con soporte de MCP remoto (Streamable HTTP + OAuth 2.1) funciona con la misma URL. El servidor publica sus metadatos en:

  • https://mcp.tupana.ai/.well-known/oauth-protected-resource
  • https://mcp.tupana.ai/.well-known/oauth-authorization-server

Si tu cliente solo soporta stdio, usa un puente como mcp-remote:

json
{  "mcpServers": {    "tupana": {      "command": "npx",      "args": ["-y", "mcp-remote", "https://mcp.tupana.ai/mcp"]    }  }}

Desde tu propio agente

En tupana-ai/tupana-examples hay un agente en Python (API de Claude + cliente MCP) que factura pidiéndote confirmación antes de emitir.

Herramientas

Documentos y facturación

HerramientaQué hace
get_documentsConsulta documentos tributarios (facturas, boletas, notas de crédito…).
search_documentsBusca documentos emitidos por cliente, monto o folio.
get_document_linkLink (PDF) de un documento emitido.
create_sale_invoiceCrea un borrador de factura afecta (33) o exenta (34), con referencias (OC 801, HES).
create_purchase_invoiceCrea un borrador de factura de compra (46).
create_export_invoiceCrea un borrador de factura de exportación (110).
create_receiptCrea un borrador de boleta (39 o 41).
create_fee_receiptCrea un borrador de boleta de honorarios.
create_dispatch_guideCrea un borrador de guía de despacho (52).
create_credit_noteCrea una nota de crédito (61) que referencia una factura (anulación o corrección).
create_debit_noteCrea una nota de débito (56) que referencia una factura.
parse_spreadsheet_to_invoicesConvierte una planilla en borradores de factura (facturación masiva).
get_document_preview / get_document_previewsVista previa en PDF de uno o varios borradores, para que los revises.
emit_document / emit_documentsEmite al SII uno o varios borradores ya revisados. Exige vista previa previa.
send_document_emailReenvía un documento emitido por correo.
create_scheduled_invoiceCrea una factura programada (recurrente).
get_scheduled_documentsLista los documentos programados.
parse_document_to_invoiceExtrae ítems de una orden de compra o PDF para facturarla.

Clientes, proveedores y empresas

HerramientaQué hace
get_entity_infoTus empresas en Tupana.
find_clientsBusca clientes (receptores).
enrich_client_from_rutDatos del contribuyente en el SII a partir de su RUT.
get_suppliersProveedores según las facturas de compra recibidas.
get_top_clientsRanking de clientes por monto o cantidad facturada.
get_top_productsRanking de productos o ítems vendidos.
get_cross_sell_clientsClientes que compraron un producto pero no otro.

Reportes, libros e impuestos

HerramientaQué hace
report_documentsTotales de documentos emitidos por mes, tipo, cliente o estado.
get_monthly_revenueSerie mensual de ventas.
get_sii_booksLibros de compra y venta del SII.
get_f29_summaryResumen del F29 del período.
get_tax_summaryResumen de IVA crédito y débito fiscal.

Cobranza y conciliación bancaria

HerramientaQué hace
get_pending_invoicesFacturas pendientes de pago (cuentas por cobrar y por pagar).
get_bank_movementsMovimientos bancarios y su estado de conciliación.
get_payment_documentsDocumentos de pago (tipo 100).
get_reconciliation_suggestionsSugerencias de conciliación con puntaje automático.
reconcile_movementConcilia un movimiento con una o más facturas.
get_reconciliationsHistorial de conciliaciones.

Cesión de facturas (factoring)

HerramientaQué hace
prepare_cessionPrepara la cesión de una factura emitida a un factoring.
execute_cessionEjecuta en el SII una cesión ya preparada y revisada.
get_cession_statusEstado de una cesión.

Base pública de empresas del SII

HerramientaQué hace
search_sii_companiesBusca empresas de Chile en la nómina pública del SII.
find_sii_prospectsEncuentra clientes potenciales por rubro, región y tamaño.
find_growing_sii_companiesEmpresas que crecieron entre dos años.
get_sii_company_historyTrayectoria de una empresa en la nómina.
get_sii_market_summaryTamaño de un mercado (empresas y trabajadores).
get_sii_companies_metadataFiltros disponibles (años, tramos, regiones, rubros).

Construir facturación en tu SaaS

HerramientaQué hace
get_capabilitiesQué puede hacer Tupana y con qué herramienta empezar.
get_invoice_flowEl flujo completo de facturación, paso a paso.
get_invoice_ui_specEspecificación del frontend (campos, tipos, condiciones).
get_invoice_validation_schemaReglas de validación del borrador por paso y campo.
validate_invoice_draftValida un borrador con las mismas reglas de la API.
get_customer_lookup_flowDe RUT a razón social, actividades y direcciones.
get_invoice_item_rulesReglas de las líneas de la factura.
get_invoice_reference_rulesReglas de las referencias según el tipo de documento.
get_invoice_preview_flowCómo pedir y mostrar la vista previa.
get_invoice_issuance_flowCómo emitir, qué estados hay y qué devuelve.
get_async_strategyWebhook + WebSocket o polling, según tu stack.
get_integration_setupAPI key, enrolamiento, webhooks y sandbox.
get_invoice_contract_findingsQué reglas están confirmadas en código y cuáles son declaradas.
get_error_resolutionQué significa un error de Tupana o del SII y qué hacer.
get_design_systemTokens del design system de Tupana.

Conexión de empresas y navegación

HerramientaQué hace
get_tupana_connect_guideCómo enrolar una empresa con Tupana Connect.
open_tupana_connectAbre Tupana Connect y devuelve el link (facturación SII, lectura SII o banco).
get_app_linkLink directo a la pantalla de la app para lo que se hace por interfaz.
get_app_guideGuía de navegación de la app.
list_capabilitiesResponde "¿qué puedes hacer?".
how_toTutorial paso a paso para una tarea.

La lista refleja el servidor al momento de publicar este repositorio. La fuente de verdad es tools/list del propio servidor.

Directorios

  • MCP Registry oficial: server.json (io.github.tupana-ai/tupana). Para publicarlo o actualizarlo, ejecuta el workflow Publicar en el MCP Registry (Actions → Run workflow), que se autentica con GitHub OIDC; o desde tu máquina:

    bash
    brew install mcp-publishermcp-publisher login github   # con una cuenta miembro de la organización tupana-aimcp-publisher publish

  • Glama: glama.json declara a los mantenedores. Glama indexa el repositorio como servidor (glama.ai/mcp/servers/tupana-ai/tupana-mcp) y el endpoint remoto como conector (glama.ai/mcp/connectors/io.github.tupana-ai/tupana).

  • Smithery: se publica por URL en smithery.ai/new (o smithery mcp publish "https://mcp.tupana.ai/mcp" -n @tupana/tupana); no requiere archivo de configuración en el repositorio.

Recursos

Licencia

La documentación y los archivos de este repositorio están bajo licencia MIT. El servidor MCP es un servicio alojado por Tupana.

English summary

Remote MCP server for Tupana: Chilean electronic invoicing (SII), collections, bank reconciliation, sales reports and invoice cession, at https://mcp.tupana.ai/mcp (Streamable HTTP, OAuth 2.1 with PKCE and dynamic client registration; scopes tupana:read / tupana:write). Add it as a custom connector in Claude, with claude mcp add --transport http tupana https://mcp.tupana.ai/mcp in Claude Code, via mcp.json in Cursor or VS Code, or as a developer-mode connector in ChatGPT. Irreversible actions (issuing to the SII, sending email, reconciling) are designed to require confirmation: the agent creates a draft, shows a PDF preview and only issues with emit_document after you approve. Registry metadata lives in server.json (io.github.tupana-ai/tupana).

Source: README.md at commit e8bf7ce

Tools

0
This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

2
  1. v0.1.1LatestOct 23, 2026
  2. v0.1.0Oct 20, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts