Moon Banking MCP Server

Moon Banking is a global directory of consumer and business banks with structured, community-rated scores across 14 categories — customer service, fees & pricing, digital experience, crypto friendliness, security & trust, lending, business banking, international banking, transparency, and more. The Moon Banking MCP server exposes that entire dataset — every bank, country, score, vote, and user story — as live tools your AI agent can call, so answers about real-world banking are grounded in fresh Moon Banking data instead of stale training-set guesses.

Once connected, you can ask questions like "which crypto-friendly banks operate in Brazil?", "compare digital-experience scores for the top US challenger banks", or "summarize recent user stories about fees at HSBC UK" and get tool-grounded, citable answers backed by the same data that powers moonbanking.com.

The server is generated from the public OpenAPI specification and ships as both a hosted OAuth endpoint at https://mcp.moonbanking.com/mcp and a stdio npm package (@moonbanking/mcp-server) — so you can connect it to Claude, Cursor, Grok, ChatGPT, VS Code, Devin Desktop (formerly Windsurf), Zed, and any other Model Context Protocol client.

Client-specific setup guides

If you just want to wire Moon Banking up to a specific client, jump straight to its guide. Each one covers both the hosted OAuth setup and the self-hosted stdio fallback.

The rest of this README covers the underlying authentication options and configuration shapes.

Authentication

You can connect to Moon Banking over MCP using either of two auth methods:

Both methods expose the same tool surface; pick whichever matches your client.

Hosted MCP server (OAuth)

URL: https://mcp.moonbanking.com/mcp (Streamable HTTP, OAuth 2.0 with Dynamic Client Registration).

Most modern MCP clients can connect by simply pointing at the URL — they will pop a browser window for the user to sign in to Moon Banking and obtain an access token automatically. No API key is exchanged or stored on the client side.

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

For clients that don't yet speak remote MCP natively (eg. older ChatGPT configurations), the mcp-remote bridge can wrap the hosted endpoint as a stdio command:

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

Self-hosted (API key)

If you prefer to run the MCP server locally as a stdio process — for example to embed it in an automation that doesn't have a browser available for OAuth — install this npm package and authenticate with a Moon Banking API key.

Direct invocation

You can run the MCP Server directly via npx:

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

Via MCP Client

There is a partial list of existing clients at modelcontextprotocol.io. If you already have a client, consult their documentation to install the MCP server.

For clients with a configuration JSON, it might look something like this:

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

Filter Specific Tools

You can limit which tools are exposed by using the --tool flag:

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

Available Tools

• bank_getByHostname: Retrieve banks by hostname, up to one bank per country. The hostname is normalized (www. prefix removed if present) and matched against both the primary hostname and alternative hostnames.
• bank_get: Retrieve a paginated list of banks, ten per page by default. Search by name, filter by country, sort by various fields, and include related data such as scores and country information.
• bank_getById: Retrieve a bank by ID. Optionally include related data such as scores and country information.
• bank_semanticSearch: Search for banks by describing what you are looking for in natural language. Searches across bank descriptions including services offered, history, location, unique features, and institution type. Use when the user asks about banks with specific characteristics, services, or qualities.
• bankVote_get: Retrieve a paginated list of bank votes. Filter by bank ID, category, country, vote type (upvote or downvote), and other parameters.
• bankProduct_list: Retrieve a paginated list of published bank products across all banks to compare rates and terms between institutions. Filter by bank, country, category, type, currency, and rate, and sort by rate to find the most competitive offers. Products are supplied and maintained by each bank's own verified representatives. Every product includes the name of the bank that offers it.
• bankProduct_listByBank: Retrieve the products and services a bank publishes on its Moon Banking profile, such as deposit accounts, loans, and credit cards. Products are supplied and maintained by the bank's own verified representatives. Only published products are returned; drafts, archived entries, and anything removed by the Moon Banking team are excluded.
• bankProduct_create: Add a product to the bank's profile. Products default to published and appear on the bank's public page immediately. Pass status as DRAFT to stage a product without publishing it. Requires an approved representative of the bank.
• bankProduct_listForOwnedBank: Retrieve every product on the bank's profile, including drafts and archived entries that the public list omits. Use it to reconcile your own catalog against Moon Banking before syncing changes. Requires an approved representative of the bank.
• bankProduct_update: Replace a product's details. Every writable field is overwritten, so send the product's full state rather than only the fields that changed. Call this when rates or fees move. Requires an approved representative of the bank.
• bankProduct_delete: Permanently remove a product from the bank's profile. This cannot be undone. To retire a product while keeping its record, set its status to ARCHIVED instead. Requires an approved representative of the bank.
• bankProduct_setStatus: Move a product between draft, published, and archived without resubmitting its details. Archiving is the reversible way to retire a product you may bring back; deleting is permanent. Requires an approved representative of the bank.
• country_get: Retrieve a paginated list of countries, ten per page by default. Search by name or 2-letter code, sort by various fields, and include related data such as scores.
• country_getByCountryCode: Retrieve a country by its 2-letter ISO code. Optionally include related data such as scores.
• story_get: Retrieve a paginated list of stories, ten per page by default. Search by text content, filter by bank ID, sort by various fields, and include related data such as bank and country information.
• story_getById: Retrieve a story by ID. Optionally include related data such as bank and country information.
• world_getOverview: Retrieve global overview data aggregating bank votes, stories, and other data across all banks in all countries. Optionally include related data such as scores.
• market_get: Retrieve a paginated list of markets, such as stock exchanges. Search by name or code, filter by exact code, country, or market type, and sort the results.
• market_getById: Retrieve a market, such as a stock exchange, by ID.
• stock_get: Retrieve a paginated list of stock listings. Search by ticker symbol, filter by exact symbol, market, bank, or primary-listing status, and sort the results.
• stock_getById: Retrieve a stock listing by ID. Optionally include the associated market and/or bank as nested objects.
• search_get: Search across banks, countries, stories, and stocks. Use the include parameter to specify which entities to search; if no include value is provided, all entities are searched. Banks are also matched on the ticker symbol of their stock listings, so searching BAC returns Bank of America.

License

MIT