NotaMCP

Working

io.github.CssEoCAO/notamcpv1.0.0 GitHub verified

Issue Brazilian service invoices (NFS-e Nacional) from your AI, with preview and confirmation.

Finance & Payments

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://notamcp.com.br/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

cancelar_nota Destructive

Cancela uma NFS-e autorizada na SEFIN. Exige confirmar=true — peça confirmação explícita ao usuário antes. O crédito da emissão NÃO volta (a nota existiu); o cancelamento é grátis.

motivostring, required

Motivo em texto (vai para a SEFIN).

nota_idinteger, required

confirmarboolean, required

Precisa ser true — confirmação do usuário nesta conversa.

codigo_motivointeger

1=erro na emissão · 2=serviço não prestado · 4=duplicidade.

The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.

I understand, run it anyway

Tools (10)

cancelar_nota

Cancela uma NFS-e autorizada na SEFIN. Exige confirmar=true — peça confirmação explícita ao usuário antes. O crédito da emissão NÃO volta (a nota existiu); o cancelamento é grátis.

destructive

Argument	Type	Description
motivo*	string	Motivo em texto (vai para a SEFIN).
nota_id*	integer
confirmar*	boolean	Precisa ser true — confirmação do usuário nesta conversa.
codigo_motivo	integer	1=erro na emissão · 2=serviço não prestado · 4=duplicidade.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "nota_id",
    "motivo",
    "confirmar"
  ],
  "properties": {
    "motivo": {
      "type": "string",
      "description": "Motivo em texto (vai para a SEFIN)."
    },
    "nota_id": {
      "type": "integer"
    },
    "confirmar": {
      "type": "boolean",
      "description": "Precisa ser true — confirmação do usuário nesta conversa."
    },
    "codigo_motivo": {
      "enum": [
        1,
        2,
        4
      ],
      "type": "integer",
      "description": "1=erro na emissão · 2=serviço não prestado · 4=duplicidade."
    }
  }
}

comprar_creditos

Gera um link de pagamento (Pix/cartão) para adicionar créditos de notas. Entregue o link ao usuário — o pagamento acontece no navegador dele e as notas entram após a confirmação.

Argument	Type	Description
valor_centavos*	integer	Valor da recarga em centavos: 1000 (R$10), 2500 (R$25), 5000 (R$50) ou 10000 (R$100).

Input schema (JSON)

{
  "type": "object",
  "required": [
    "valor_centavos"
  ],
  "properties": {
    "valor_centavos": {
      "enum": [
        1000,
        2500,
        5000,
        10000
      ],
      "type": "integer",
      "description": "Valor da recarga em centavos: 1000 (R$10), 2500 (R$25), 5000 (R$50) ou 10000 (R$100)."
    }
  }
}

confirmar_emissao

Emite DE VERDADE a nota da prévia. Chame apenas depois que o usuário aprovou a prévia nesta conversa. Idempotente: o mesmo token nunca emite duas vezes. Autorizada, devolve danfse_url (PDF) e xml_url — links para o usuário abrir, que você não consegue baixar.

destructive

Argument	Type	Description
confirmacao_token*	string	Token devolvido por emitir_nota.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "confirmacao_token"
  ],
  "properties": {
    "confirmacao_token": {
      "type": "string",
      "description": "Token devolvido por emitir_nota."
    }
  }
}

consultar_nota

Situação de uma nota desta conta (status, número, chave de acesso, erro).

read-only

Argument	Type	Description
nota_id*	integer	Id da nota (veio da emissão ou de listar_notas).

Input schema (JSON)

{
  "type": "object",
  "required": [
    "nota_id"
  ],
  "properties": {
    "nota_id": {
      "type": "integer",
      "description": "Id da nota (veio da emissão ou de listar_notas)."
    }
  }
}

emitir_nota

Prepara uma NFS-e e devolve a PRÉVIA + confirmacao_token. NÃO emite nada. Mostre a prévia ao usuário e chame confirmar_emissao só depois do OK explícito dele. Tomador: informe tomador_id (salvo) OU tomador_doc + tomador_razao.

Argument	Type	Description
valor*	string	Valor do serviço em reais, ex.: "1250,00".
tomador_id	string	Id de um tomador salvo (listar_tomadores).
competencia	string	Mês de referência YYYY-MM. Vazio = mês atual.
tomador_doc	string	CNPJ (14 dígitos) ou CPF (11) do tomador.
configuracao	object	Configuração fiscal só desta nota. Campos omitidos herdam o cadastro/configuracao_id. Nunca invente códigos fiscais.
tomador_pais	string	País ISO2 do tomador estrangeiro (ex.: "SG").
tomador_tipo	string	Use "exterior" para tomador estrangeiro.
discriminacao*	string	Descrição do serviço, como sai impressa na nota.
tomador_razao

listar_configuracoes

Últimas combinações realmente usadas de serviço, CNAE, NBS e tributação. Use configuracao_id em emitir_nota. Se houver ambiguidade, pergunte ao usuário — não escolha nem invente código fiscal.

read-only

Argument	Type	Description
limite	integer	Máximo de combinações (1–20, padrão 8).

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "limite": {
      "type": "integer",
      "description": "Máximo de combinações (1–20, padrão 8)."
    }
  }
}

listar_notas

Histórico de notas da conta, com filtros opcionais.

read-only

Argument	Type	Description
limite	integer	Máx. de notas (1–100, padrão 20).
status	string	Filtro por status.
competencia	string	Filtro YYYY-MM.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "limite": {
      "type": "integer",
      "description": "Máx. de notas (1–100, padrão 20)."
    },
    "status": {
      "enum": [
        "emitida",
        "rejeitada",
        "pendente",
        "cancelada",
        "erro"
      ],
      "type": "string",
      "description": "Filtro por status."
    },
    "competencia": {
      "type": "string",
      "description": "Filtro YYYY-MM."
    }
  }
}

listar_tomadores

Tomadores salvos desta conta (use o id em emitir_nota). Passe `busca` com o NOME que o usuário falou para achar o tomador sem precisar do CNPJ — ignora acento, caixa e pontuação. Se voltar mais de um, pergunte qual antes de emitir.

read-only

Argument	Type	Description
busca	string	Nome (ou parte) da empresa, ou o documento. Ex.: "acai" acha "Açaí & Cia Ltda".

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "busca": {
      "type": "string",
      "description": "Nome (ou parte) da empresa, ou o documento. Ex.: \"acai\" acha \"Açaí & Cia Ltda\"."
    }
  }
}

saldo

Quantidade de notas disponíveis, preço por nota, ambiente e teto diário. O nome técnico saldo é mantido por compatibilidade.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

salvar_tomador

Salva/atualiza um tomador frequente (ex.: "salva a Shopee como tomador").

destructive

Argument	Type	Description
doc	string	CNPJ ou CPF (só números ou formatado).
pais	string	ISO2, só para exterior.
tipo	string
razao*	string	Razão social ou nome.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "razao"
  ],
  "properties": {
    "doc": {
      "type": "string",
      "description": "CNPJ ou CPF (só números ou formatado)."
    },
    "pais": {
      "type": "string",
      "description": "ISO2, só para exterior."
    },
    "tipo": {
      "enum": [
        "",
        "exterior"
      ],
      "type": "string"
    },
    "razao": {
      "type": "string",
      "description": "Razão social ou nome."
    }
  }
}

{ "type": "object", "required": [ "valor", "discriminacao" ], "properties": { "valor": { "type": "string", "description": "Valor do serviço em reais, ex.: \"1250,00\"." }, "tomador_id": { "type": "string", "description": "Id de um tomador salvo (listar_tomadores)." }, "competencia": { "type": "string", "description": "Mês de referência YYYY-MM. Vazio = mês atual." }, "tomador_doc": { "type": "string", "description": "CNPJ (14 dígitos) ou CPF (11) do tomador." }, "configuracao": { "type": "object", "properties": { "ctrib_mun": { "type": "string", "description": "Código de tributação definido pela prefeitura; vazio quando não houver." }, "codigo_nbs": { "type": "string", "description": "NBS, se aplicável." }, "codigo_cnae": { "type": "string", "description": "CNAE do serviço, com 7 dígitos." }, "aliquota_iss": { "type": "string", "description": "Percentual do ISS quando destacado." }, "calcular_iss": { "type": "boolean" }, "trib_federal": { "type": "string", "description": "Tributos federais aproximados (%)." }, "codigo_servico": { "type": "string", "description": "Item da LC 116, ex.: 17.06 ou 17.06.01. Não é CNAE." }, "trib_municipal": { "type": "string", "description": "Tributos municipais aproximados (%)." }, "aliquota_simples": { "type": "string", "description": "Percentual efetivo do Simples." } }, "description": "Configuração fiscal só desta nota. Campos omitidos herdam o cadastro/configuracao_id. Nunca invente códigos fiscais." }, "tomador_pais": { "type": "string", "description": "País ISO2 do tomador estrangeiro (ex.: \"SG\")." }, "tomador_tipo": { "enum": [ "", "exterior" ], "type": "string", "description": "Use \"exterior\" para tomador estrangeiro." }, "discriminacao": { "type": "string", "description": "Descrição do serviço, como sai impressa na nota." }, "tomador_razao": { "type": "string", "description": "Razão social ou nome do tomador." }, "configuracao_id": { "type": "string", "description": "Id de uma combinação devolvida por listar_configuracoes." } } }