contix

npx add-mcp 'https://api.contix.es/api/v1/mcp/herramientas'

Servidor MCP contix: Faturação espanhola com Veri*factu

Gere a sua faturação espanhola a partir do Claude, ChatGPT, Cursor ou qualquer cliente MCP: clientes, faturas com a cadeia de hash Veri*factu e QR, pagamentos, despesas, orçamentos, faturas recorrentes, Facturae/FACe para a administração pública, valores do Modelo 303/349/390 e um espaço de trabalho para o seu contabilista (gestoría). Alojado pela contix, sem necessidade de instalação. Este repositório contém os metadados públicos; o código do servidor não é open source.

https://api.contix.es/api/v1/mcp

HTTP streamable · OAuth 2.1 (registo dinâmico de clientes + PKCE) ou chave de API (Authorization: Bearer cx_live_…, só leitura ou leitura/escrita) · requer uma conta contix (teste de 30 dias). Passos irreversíveis, como finalizar uma fatura na cadeia Veri*factu, pedem confirmação explícita.

Configuração para Claude, ChatGPT e Cursor: contix.es/mcp · Referência da API: contix.es/api · OpenAPI: https://api.contix.es/openapi.json

Todas as 63 ferramentas

Faturas

• create_invoice: Criar fatura em rascunho
• update_invoice: Atualizar fatura em rascunho
• get_invoice: Obter detalhes da fatura · só leitura
• list_invoices: Listar faturas · só leitura
• finalize_invoice: Finalizar fatura (irreversível) · pede confirmação / irreversível
• clone_invoice: Clonar fatura para rascunho
• rectify_invoice: Retificar fatura (Veri*factu)
• cancel_invoice: Cancelar/anular fatura (irreversível) · pede confirmação / irreversível
• delete_invoice: Eliminar fatura em rascunho
• send_invoice: Enviar fatura por email

Clientes e pagamentos

• list_customers: Listar clientes · só leitura
• get_customer: Obter cliente · só leitura
• create_customer: Criar cliente
• update_customer: Atualizar cliente
• record_payment: Registar um pagamento
• list_payments: Listar pagamentos de uma fatura · só leitura
• get_account_statement: Extrato de conta do cliente · só leitura
• send_reminder: Enviar lembrete de pagamento
• list_reminders_sent: Listar lembretes enviados · só leitura
• check_vat_number: Verificar um NIF da UE (VIES) · só leitura

Orçamentos e faturas recorrentes

• list_quotes: Listar orçamentos · só leitura
• create_quote: Criar orçamento
• send_quote: Enviar orçamento por email
• convert_quote_to_invoice: Converter orçamento em fatura
• list_recurring: Listar perfis recorrentes · só leitura
• create_recurring: Criar perfil recorrente
• generate_recurring: Gerar fatura a partir de perfil recorrente

Despesas e fornecedores

• list_expenses: Listar despesas · só leitura
• create_expense: Criar despesa
• update_expense: Editar despesa
• delete_expense: Eliminar despesa
• list_suppliers: Listar fornecedores · só leitura

Valores fiscais e administração pública

• get_modelo: Obter modelo fiscal AEAT (modelo) · só leitura
• check_period: Verificar um período antes de o entregar · só leitura
• get_invoice_facturae: Obter XML Facturae (B2G) · só leitura
• submit_invoice_to_face: Submeter fatura ao FACe (B2G)
• get_face_status: Obter estado do FACe (B2G) · só leitura
• calculate_modelo_303: Somar a declaração de IVA espanhola (Modelo 303) · só leitura
• get_obligation_dates: Prazos Veri*factu e faturação eletrónica (Espanha) · só leitura
• validate_iban: Validar um IBAN · só leitura

Definições

• get_invoice_series: Obter série/numeração de faturas · só leitura
• set_invoice_series: Definir série/numeração de faturas
• get_invoice_defaults: Obter predefinições de faturas · só leitura
• set_invoice_defaults: Definir predefinições de faturas
• get_invoice_footer: Obter rodapé de faturas · só leitura
• set_invoice_footer: Definir rodapé de faturas
• get_product_groups: Obter grupos de produtos · só leitura
• set_product_groups: Definir grupos de produtos
• get_subscription_status: Obter estado da subscrição/teste · só leitura

Para contabilistas (gestorías) e seus clientes

• invite_gestoria: Convidar a sua gestoría
• gestoria_listar_mandantes: Listar clientes da gestoría · só leitura
• gestoria_invitar_mandante: Convidar um cliente da gestoría
• gestoria_abrir_mandante: Abrir um cliente da gestoría
• gestoria_resumen_mandante: Cliente da gestoría: valores de um período · só leitura
• gestoria_facturas_mandante: Cliente da gestoría: listar faturas · só leitura
• gestoria_gastos_mandante: Cliente da gestoría: listar despesas · só leitura
• gestoria_revision_mandante: Cliente da gestoría: o que falta · só leitura
• gestoria_export: Exportar todos os clientes da gestoría · só leitura
• gestoria_certificado_mandante: Certificado de conformidade para um cliente da gestoría · só leitura
• gestoria_comisiones: Ganhos da gestoría com a contix · só leitura
• gestoria_cierre_config: Lembretes de fecho trimestral: definições atuais · só leitura
• gestoria_cierre_configurar: Lembretes de fecho trimestral: alterar definições
• gestoria_cierre_vista_previa: Lembrete de fecho trimestral: pré-visualização para um cliente · só leitura

O servidor MCP, a API REST e o painel web funcionam no mesmo motor. A lista atual está em tools/list no endpoint.

Ferramentas gratuitas sem conta

Um segundo servidor mais pequeno, com quatro ferramentas só de leitura, sem conta e sem autenticação:

https://api.contix.es/api/v1/mcp/herramientas

• validate_iban: Verificação de IBAN (comprimento do país, dígitos de verificação ISO 13616); para IBANs espanhóis também os dígitos de verificação da conta e o banco com o seu BIC do registo do Banco de España. Um número de conta espanhol de 20 dígitos é convertido no seu IBAN.
• check_vat_number: Consulta de NIF da UE no registo VIES da Comissão Europeia.
• calculate_modelo_303: soma as caixas da declaração trimestral de IVA espanhola com as fórmulas do formulário oficial da AEAT.
• get_obligation_dates: Datas Veri*factu e de faturação eletrónica B2B obrigatória a partir das regras publicadas.

As mesmas ferramentas como API REST sem chave: https://api.contix.es/api/v1/herramientas (docs). No navegador: contix.es/herramientas.

Configuração

{
  "mcpServers": {
    "contix": { "type": "http", "url": "https://api.contix.es/api/v1/mcp" },
    "contix-herramientas": { "type": "http", "url": "https://api.contix.es/api/v1/mcp/herramientas" }
  }
}

Clientes sem OAuth: adicione "headers": { "Authorization": "Bearer cx_live_YOUR_KEY" } à entrada contix; a chave é criada no painel contix em Ajustes → Chaves de API.

Registo

Ambos os servidores estão no Registo Oficial MCP como es.contix/contix e es.contix/herramientas (os ficheiros server.json aqui são cópias).

Contacto

martin@contix.es · Privacidade · Termos

A contix é um software que emite faturas, não é um serviço de consultoria fiscal. Os resultados são o que introduz, calculados; o que é correto para o seu caso decide com a sua gestoría.