# NotaMCP (remote · notamcp.com.br)

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

- Trust score: 77/100 (medium)
- Change this week: +4
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-05

## Components

- remote · `notamcp.com.br`: 77/100 (this document), [markdown](https://verifymcp.io/servers/csseocao-notamcp/notamcp.md), [page](https://verifymcp.io/servers/csseocao-notamcp/notamcp)

## Channel facts

- Endpoint: `https://notamcp.com.br/mcp`
- Transports: `streamable-http`
- Auth: `required`
- Version: `1.0.0`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-05.

- **Endpoint Security**: 83/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation is enforced on tool calls, advertised via RFC 9728 protected-resource metadata. Discovery is public, which costs nothing: no tool can be invoked without a token.
  - HTTPS check failed: the endpoint is reachable over plaintext HTTP.
  - The HSTS (Strict-Transport-Security) header is present.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
  - The authorisation server offers only Dynamic Client Registration (RFC 7591), which MCP 2026-07-28 deprecated in favour of Client ID Metadata Documents.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 67/100
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 1554 tokens (~155/item across 10 items; 10 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 27/100
  - Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 97/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 92% of tool parameters carry a description.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 10 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 11 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### How do I install the NotaMCP MCP server?

NotaMCP is a hosted endpoint at https://notamcp.com.br/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add --transport http csseocao-notamcp 'https://notamcp.com.br/mcp'
```

### Cursor

```json
{
  "mcpServers": {
    "csseocao-notamcp": {
      "url": "https://notamcp.com.br/mcp"
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "csseocao-notamcp": {
      "type": "http",
      "url": "https://notamcp.com.br/mcp"
    }
  }
}
```

### Codex

```toml
[mcp_servers.csseocao-notamcp]
url = "https://notamcp.com.br/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "csseocao-notamcp": {
      "type": "remote",
      "url": "https://notamcp.com.br/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add csseocao-notamcp --url 'https://notamcp.com.br/mcp' --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  csseocao-notamcp:
    url: "https://notamcp.com.br/mcp"
```

### Netclaw

```json
{
  "McpServers": {
    "csseocao-notamcp": {
      "Transport": "http",
      "Url": "https://notamcp.com.br/mcp"
    }
  }
}
```

### Vellum

```bash
assistant mcp add csseocao-notamcp -t streamable-http -u 'https://notamcp.com.br/mcp'
```

### Other

```json
{
  "mcpServers": {
    "csseocao-notamcp": {
      "type": "http",
      "url": "https://notamcp.com.br/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-11-05 (score 77, +1)

No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-03 (score 76, +1)

No change was recorded against any check on this day. Stability & Change Management went from 17 to 20. That category is still filling its 30-day observation window: 5 days of observed history at the previous scan, 6 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-01 (score 75, +1)

No change was recorded against any check on this day. Stability & Change Management went from 10 to 13. That category is still filling its 30-day observation window: 3 days of observed history at the previous scan, 4 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-10-30 (score 74, +1)

No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-10-29 (score 73, 0)

- [functional improvement] Stability: unverified → 0.03

### 2026-10-28 (score 73)

First indexed and scored.

## MCP tools (10)

### `emitir_nota` (~290 tokens)

Preparar emissão de NFS-e (prévia)

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.

Input parameters:

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

### `listar_configuracoes` (~76 tokens)

Listar configurações fiscais recentes

Ú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.

Input parameters:

- `limite` (integer): Máximo de combinações (1–20, padrão 8).

### `confirmar_emissao` (~94 tokens)

Confirmar e emitir a NFS-e

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.

Input parameters:

- `confirmacao_token` (string, required): Token devolvido por emitir_nota.

### `consultar_nota` (~48 tokens)

Consultar uma nota

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

Input parameters:

- `nota_id` (integer, required): Id da nota (veio da emissão ou de listar_notas).

### `listar_notas` (~62 tokens)

Listar notas

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

Input parameters:

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

### `cancelar_nota` (~125 tokens)

Cancelar uma 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.

Input parameters:

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

### `listar_tomadores` (~107 tokens)

Listar tomadores salvos

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.

Input parameters:

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

### `salvar_tomador` (~85 tokens)

Salvar tomador

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

Input parameters:

- `doc` (string): CNPJ ou CPF (só números ou formatado).
- `pais` (string): ISO2, só para exterior.
- `razao` (string, required): Razão social ou nome.
- `tipo` (string)

### `saldo` (~33 tokens)

Créditos de notas e limites

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

### `comprar_creditos` (~97 tokens)

Adicionar créditos de notas

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.

Input parameters:

- `valor_centavos` (integer, required): Valor da recarga em centavos: 1000 (R$10), 2500 (R$25), 5000 (R$50) ou 10000 (R$100).

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/csseocao-notamcp/notamcp#diagnostics

## Score history

- 2026-11-05: 77
- 2026-11-04: 76
- 2026-11-03: 76
- 2026-11-02: 75
- 2026-11-01: 75
- 2026-10-31: 74
- 2026-10-30: 74
- 2026-10-29: 73
- 2026-10-28: 73

## Common questions

### What is the NotaMCP MCP server?

NotaMCP is an MCP server listed in the public MCP registry as io.github.CssEoCAO/notamcp. Issue Brazilian service invoices (NFS-e Nacional) from your AI, with preview and confirmation. This page covers its hosted endpoint (https://notamcp.com.br/mcp).

### Is the NotaMCP MCP server safe to use?

NotaMCP scores 77 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the NotaMCP MCP server expose?

NotaMCP exposes 10 tools: emitir_nota, listar_configuracoes, confirmar_emissao, consultar_nota, listar_notas, and 5 more. Their descriptions and schemas cost roughly 1,017 tokens of context every time the server is loaded.

### Does the NotaMCP MCP server require authentication?

Yes. NotaMCP asked us for credentials when we connected, so you will need to authorise it in your MCP client before it can do anything.

### Is the NotaMCP MCP server still maintained?

NotaMCP is still listed as active in the MCP registry. We last reached this channel on 5 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

## Links

- Remote endpoint: https://notamcp.com.br/mcp
- Website: https://notamcp.com.br/
- Changelog RSS feed: https://verifymcp.io/servers/csseocao-notamcp/notamcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/csseocao-notamcp/notamcp.json
- HTML version of this page: https://verifymcp.io/servers/csseocao-notamcp/notamcp