Servidor MCP de Moon Banking

Moon Banking es un directorio global de bancos de consumo y empresas con puntuaciones estructuradas y valoradas por la comunidad en 14 categorías: atención al cliente, comisiones y precios, experiencia digital, afinidad con criptomonedas, seguridad y confianza, préstamos, banca empresarial, banca internacional, transparencia y más. El servidor MCP de Moon Banking expone todo ese conjunto de datos (cada banco, país, puntuación, voto e historia de usuario) como herramientas en vivo que tu agente de IA puede invocar, de modo que las respuestas sobre banca del mundo real se basen en datos actualizados de Moon Banking en lugar de conjeturas obsoletas del conjunto de entrenamiento.

Una vez conectado, puedes hacer preguntas como "¿qué bancos afines a las criptomonedas operan en Brasil?", "compara las puntuaciones de experiencia digital de los principales bancos challenger de EE. UU." o "resume historias de usuario recientes sobre comisiones en HSBC UK" y obtener respuestas fundamentadas en herramientas y citables, respaldadas por los mismos datos que impulsan moonbanking.com.

El servidor se genera a partir de la especificación OpenAPI pública y se distribuye tanto como un endpoint OAuth alojado en https://mcp.moonbanking.com/mcp como un paquete npm stdio (@moonbanking/mcp-server), de modo que puedes conectarlo a Claude, Cursor, Grok, ChatGPT, VS Code, Devin Desktop (antes Windsurf), Zed y cualquier otro cliente del Model Context Protocol.

Guías de configuración específicas por cliente

Si solo quieres conectar Moon Banking a un cliente concreto, ve directamente a su guía. Cada una cubre tanto la configuración OAuth alojada como la alternativa stdio autoalojada.

El resto de este README cubre las opciones de autenticación subyacentes y las formas de configuración.

Related MCP server: WalletGrower MCP Server

Autenticación

Puedes conectarte a Moon Banking a través de MCP usando cualquiera de estos dos métodos de autenticación:

Ambos métodos exponen la misma superficie de herramientas; elige el que coincida con tu cliente.

Servidor MCP alojado (OAuth)

URL: https://mcp.moonbanking.com/mcp (HTTP transmisible, OAuth 2.0 con registro dinámico de clientes).

La mayoría de los clientes MCP modernos pueden conectarse simplemente apuntando a la URL: abrirán una ventana del navegador para que el usuario inicie sesión en Moon Banking y obtendrán un token de acceso automáticamente. No se intercambia ni se almacena ninguna clave de API en el lado del cliente.

{
  "mcpServers": {
    "moonbanking": {
      "url": "https://mcp.moonbanking.com/mcp"
    }
  }
}

Para los clientes que aún no admiten MCP remoto de forma nativa (por ejemplo, configuraciones antiguas de ChatGPT), el puente mcp-remote puede envolver el endpoint alojado como un comando stdio:

{
  "mcpServers": {
    "moonbanking": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.moonbanking.com/mcp"]
    }
  }
}

Autoalojado (clave de API)

Si prefieres ejecutar el servidor MCP localmente como un proceso stdio (por ejemplo, para integrarlo en una automatización que no disponga de un navegador para OAuth), instala este paquete npm y autentícate con una clave de API de Moon Banking.

Invocación directa

Puedes ejecutar el servidor MCP directamente mediante npx:

export MOON_BANKING_API_KEY="Bearer mb_sk_..."
npx -y @moonbanking/mcp-server

Mediante un cliente MCP

Hay una lista parcial de clientes existentes en modelcontextprotocol.io. Si ya tienes un cliente, consulta su documentación para instalar el servidor MCP.

Para clientes con un JSON de configuración, podría tener un aspecto similar a este:

{
  "mcpServers": {
    "moonbanking-mcp": {
      "command": "npx",
      "args": ["-y", "@moonbanking/mcp-server"],
      "env": {
        "MOON_BANKING_API_KEY": "Bearer mb_sk_..."
      }
    }
  }
}

Filtrar herramientas específicas

Puedes limitar qué herramientas se exponen usando la opción --tool:

npx @moonbanking/mcp-server --tool=tool1 --tool=tool2

Herramientas disponibles

• bank_getByHostname: este endpoint te permite recuperar bancos por nombre de host. Devolverá hasta un banco por país que coincida con el nombre de host proporcionado. El nombre de host se normaliza (se elimina el prefijo www si está presente) y se compara tanto con el nombre de host principal como con los nombres de host alternativos.

• bank_get: este endpoint te permite recuperar una lista paginada de todos los bancos. De forma predeterminada, se muestran un máximo de diez bancos por página. Puedes buscar bancos por nombre, filtrar por país, ordenarlos por varios campos e incluir datos relacionados, como puntuaciones e información del país.

• bank_getById: este endpoint te permite recuperar un banco específico proporcionando el ID del banco. Puedes incluir datos relacionados, como puntuaciones e información del país, en la respuesta.

• bank_semanticSearch: busca bancos describiendo lo que buscas en lenguaje natural. Esta búsqueda se realiza en las descripciones de los bancos, incluidos los servicios ofrecidos, la historia, la ubicación, las características únicas y el tipo de institución. Úsalo cuando el usuario pregunte por bancos con características, servicios o cualidades específicas.

• bankVote_get: este endpoint te permite recuperar una lista paginada de votos de bancos. Puedes filtrar por ID de banco, categoría, país, tipo de voto (voto positivo o negativo) y otros parámetros.

• country_get: este endpoint te permite recuperar una lista paginada de todos los países. De forma predeterminada, se muestran un máximo de diez países por página. Puedes buscar países por nombre o código de 2 letras, ordenarlos por varios campos e incluir datos relacionados, como puntuaciones.

• country_getByCountryCode: este endpoint te permite recuperar un país específico proporcionando el código de país ISO de 2 letras. Puedes incluir datos relacionados, como puntuaciones, en la respuesta.

• story_get: este endpoint te permite recuperar una lista paginada de todas las historias. De forma predeterminada, se muestran un máximo de diez historias por página. Puedes buscar historias por contenido de texto, filtrar por ID de banco, ordenarlas por varios campos e incluir datos relacionados, como información del banco y del país.

• story_getById: este endpoint te permite recuperar una historia específica proporcionando el ID de la historia. Puedes incluir datos relacionados, como información del banco y del país, en la respuesta.

• world_getOverview: este endpoint te permite recuperar datos de visión general global que agregan votos de bancos, historias y otros datos de todos los bancos de todos los países. Puedes incluir datos relacionados, como puntuaciones, en la respuesta.

• market_get: este endpoint te permite recuperar una lista paginada de mercados (p. ej., bolsas de valores). Puedes buscar por nombre o código, filtrar por código exacto, país o tipo de mercado, y ordenar los resultados.

• market_getById: este endpoint te permite recuperar un mercado específico (p. ej., bolsa de valores) proporcionando el ID del mercado.

• stock_get: este endpoint te permite recuperar una lista paginada de cotizaciones de acciones. Puedes buscar por símbolo de ticker, filtrar por símbolo exacto, mercado, banco o estado de cotización principal, y ordenar los resultados.

• stock_getById: este endpoint te permite recuperar una cotización de acciones específica proporcionando el ID de la cotización. Opcionalmente, puedes incluir el market y/o bank asociados como objetos anidados.

• search_get: busca en bancos, países, historias y acciones. Puedes especificar qué entidades buscar mediante el parámetro include. Si no se proporciona ningún valor de include, se buscará en todas las entidades. Los bancos también se comparan con el símbolo de ticker de sus cotizaciones de acciones, por lo que buscar BAC devuelve Bank of America.

Licencia

MIT