Fortgate MCP

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

Fortgate MCP es un servidor MCP 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 en Stellar: las tareas se abren como issues, y el trabajo mergeado se recompensa con bounties transparentes.

---

Quickstart

Requisitos: Node.js 20+ y una API key de Fortgate (sandbox para desarrollo).

npx @fortgate/mcp

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

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

Variables de entorno disponibles en .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. 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

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.