# Fortgate MCP

**Identidad y KYC de Fortgate en cualquier agente, en menos de 5 minutos.**

Fortgate MCP es un servidor [MCP](https://modelcontextprotocol.io/) que expone la identidad reusable y el KYC de Fortgate como herramientas que un agente (Claude, Cursor, etc.) puede consumir directamente: iniciar un flujo KYC, consultar su estado y verificar una credencial — sin construir la integración a mano.

Este repo es parte del ecosistema [GrantFox](https://grantfox.xyz/) en Stellar: las tareas se abren como issues, y el trabajo mergeado se recompensa con bounties transparentes.

---

## Quickstart

Requisitos: [Node.js 20+](https://nodejs.org/) y una API key de Fortgate (sandbox para desarrollo).

```bash
npx @fortgate/mcp
```

Configuralo en tu cliente MCP (ejemplo para Claude Desktop / Cursor):

```json
{
  "mcpServers": {
    "fortgate": {
      "command": "npx",
      "args": ["-y", "@fortgate/mcp"],
      "env": {
        "FORTGATE_API_KEY": "tu-api-key-de-sandbox"
      }
    }
  }
}
```

Variables de entorno disponibles en [`.env.example`](.env.example).

---

## Estructura del repo

```
.
├── .github/
│   ├── ISSUE_TEMPLATE/     ← formularios de issue (Frontend, Fullstack, QA)
│   ├── PULL_REQUEST_TEMPLATE.md
│   └── workflows/          ← ci.yml (PRs) y release.yml (publish a npm)
├── src/
│   ├── index.ts            ← entrypoint del server
│   ├── server.ts           ← registro de tools
│   ├── config.ts           ← carga y valida env vars
│   ├── types.ts            ← tipos compartidos
│   └── tools/              ← una herramienta por archivo
├── test/                   ← tests con Vitest
├── PLAN.md                 ← plan de producto y arquitectura
├── CONTRIBUTING.md         ← cómo tomar una issue y abrir un PR
└── SETUP-CICD.md           ← setup del repo, CI/CD y branch protection
```

---

## Contribuir

Leé [CONTRIBUTING.md](CONTRIBUTING.md). En resumen: elegí una issue `ready`, hacé fork, trabajá en una rama `tipo/issue-descripcion`, y abrí un PR contra `main`. El CI corre lint, typecheck, test y build automáticamente; tienen que estar en verde (más una review) para mergear.

**Regla de oro:** una herramienta por archivo en `src/tools/`.

---

## Desarrollo local

```bash
npm ci
npm run lint        # ESLint + Prettier
npm run typecheck   # tsc --noEmit
npm test            # Vitest
npm run build       # compila a build/
```

## Licencia

MIT — ver [LICENSE](LICENSE).