# MCP Server - Guia da Maquininha

MCP Server que expõe dados reais de taxas de maquininha de cartão no Brasil (2026). Permite que modelos de IA consultem e comparem taxas de diferentes marcas (Stone, Cielo, Mercado Pago, PagBank, SumUp, InfinitePay, Ton, Getnet) para diferentes perfis de negócio.

## Instalação

```bash
npm install
```

## Uso

O servidor roda via stdio e segue o Model Context Protocol padrão.

### Ferramentas disponíveis

1. **get_brands** - Lista todas as marcas com taxas MDR
2. **get_tiers** - Lista perfis de negócio (MEI, pequeno, médio, grande)
3. **calculate_cost** - Calcula custo mensal real para marca + perfil
4. **compare_brands** - Compara todas as marcas e retorna ranking de custo

### Exemplo de chamada

```json
{
  "name": "compare_brands",
  "arguments": {
    "tier": "mei",
    "antecipation": false
  }
}
```

## Dados

As taxas são baseadas em pesquisa de mercado 2026 com:
- MDR crédito/débito por marca
- Taxa de antecipação
- Perfil de ticket médio e volume por tier de negócio

## Fonte

**[guiamaquininha.com.br](https://guiamaquininha.com.br)** — comparador de maquininhas de cartão no Brasil. Dados originais de taxas MDR, simuladores de custo mensal e guias práticos para pequenos negócios escolherem a adquirente certa.

## Registro MCP

Este servidor está pronto para submissão em registry.modelcontextprotocol.io

## Registry MCP (publicado)
- **Nome:** io.github.canalthailexa-lgtm/guiamaquininha (v1.0.0)
- **Status:** active — verificado na API oficial em 15/10/2026
- **API:** https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.canalthailexa-lgtm%2Fguiamaquininha
- **Endpoint remoto (streamable-http):** https://guiamaquininha-mcp.gcnovidade.workers.dev/mcp
- Agregadores de MCP sincronizam com o registry oficial — é dessa sincronização que vem a exposição/backlinks citada na técnica.