@moonbanking/mcp-server 1.5.1 → 1.7.3

package/README.md

@@ -4,7 +4,7 @@ Moon Banking is a global directory of consumer and business banks with structure
 
 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](https://moonbanking.com).
 
-The server is generated from the public [OpenAPI specification](https://github.com/moonbanking/moonbanking-openapi) 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, Windsurf, Zed, and any other [Model Context Protocol](https://modelcontextprotocol.io) client.
+The server is generated from the public [OpenAPI specification](https://github.com/moonbanking/moonbanking-openapi) 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](https://modelcontextprotocol.io) client.
 
 ## Client-specific setup guides
 
@@ -15,7 +15,7 @@ If you just want to wire Moon Banking up to a specific client, jump straight to
 | Claude (Desktop & web) | [claude](./claude.md) |
 | Claude Code | [claude-code](./claude-code.md) |
 | Cursor | [cursor](./cursor.md) |
-| Windsurf | [windsurf](./windsurf.md) |
+| Devin Desktop (formerly Windsurf) | [devin-desktop](./devin-desktop.md) |
 | VS Code (GitHub Copilot) | [vscode](./vscode.md) |
 | Zed | [zed](./zed.md) |
 | ChatGPT | [chatgpt](./chatgpt.md) |
@@ -113,12 +113,23 @@ npx @moonbanking/mcp-server --tool=tool1 --tool=tool2
 - `bank_getById`: This endpoint allows you to retrieve a specific bank by providing the bank ID. You can include related data like scores and country information in the response.
 - `bank_semanticSearch`: Search for banks by describing what you are looking for in natural language. This searches across bank descriptions including services offered, history, location, unique features, and institution type. Use this when the user asks about banks with specific characteristics, services, or qualities.
 - `bankVote_get`: This endpoint allows you to retrieve a paginated list of bank votes. You can filter by bank ID, category, country, vote type (upvote or downvote), and other parameters.
+- `bankProduct_list`: This endpoint allows you to retrieve a paginated list of published bank products across all banks, so you can 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`: This endpoint allows you to 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`: This endpoint allows a bank's verified representatives to 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. You must be an approved representative of the bank.
+- `bankProduct_listForOwnedBank`: This endpoint allows a bank's verified representatives to 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. You must be an approved representative of the bank.
+- `bankProduct_update`: This endpoint allows a bank's verified representatives to replace a product's details. Every writable field is overwritten, so send the product's full state rather than only the fields that changed. This is the endpoint to call when rates or fees move. You must be an approved representative of the bank.
+- `bankProduct_delete`: This endpoint allows a bank's verified representatives to 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. You must be an approved representative of the bank.
+- `bankProduct_setStatus`: This endpoint allows a bank's verified representatives to 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. You must be an approved representative of the bank.
 - `country_get`: This endpoint allows you to retrieve a paginated list of all countries. By default, a maximum of ten countries are shown per page. You can search countries by name or 2-letter code, sort them by various fields, and include related data like scores.
 - `country_getByCountryCode`: This endpoint allows you to retrieve a specific country by providing the 2-letter ISO country code. You can include related data like scores in the response.
 - `story_get`: This endpoint allows you to retrieve a paginated list of all stories. By default, a maximum of ten stories are shown per page. You can search stories by text content, filter by bank ID, sort them by various fields, and include related data like bank and country information.
 - `story_getById`: This endpoint allows you to retrieve a specific story by providing the story ID. You can include related data like bank and country information in the response.
 - `world_getOverview`: This endpoint allows you to retrieve global overview data that aggregates banks votes, stories and other data across all banks in all countries. You can include related data like scores in the response.
-- `search_get`: Search across banks, countries, and stories. You can specify which entities to search using the include parameter. If no include value is provided, all entities will be searched.
+- `market_get`: This endpoint allows you to retrieve a paginated list of markets (e.g. stock exchanges). You can search by name or code, filter by exact code, country, or market type, and sort the results.
+- `market_getById`: This endpoint allows you to retrieve a specific market (e.g. stock exchange) by providing the market id.
+- `stock_get`: This endpoint allows you to retrieve a paginated list of stock listings. You can search by ticker symbol, filter by exact symbol, market, bank, or primary-listing status, and sort the results.
+- `stock_getById`: This endpoint allows you to retrieve a specific stock listing by providing the stock id. You can optionally include the associated `market` and/or `bank` as nested objects.
+- `search_get`: Search across banks, countries, stories, and stocks. You can specify which entities to search using the include parameter. If no include value is provided, all entities will be searched. Banks are also matched on the ticker symbol of their stock listings, so searching `BAC` returns Bank of America.
 
 ## License
 

package/chatgpt.md

@@ -73,11 +73,22 @@ The Moon Banking MCP server exposes the following tools (identical across every
 - `bank_getById`
 - `bank_semanticSearch`
 - `bankVote_get`
+- `bankProduct_list`
+- `bankProduct_listByBank`
+- `bankProduct_create`
+- `bankProduct_listForOwnedBank`
+- `bankProduct_update`
+- `bankProduct_delete`
+- `bankProduct_setStatus`
 - `country_get`
 - `country_getByCountryCode`
 - `story_get`
 - `story_getById`
 - `world_getOverview`
+- `market_get`
+- `market_getById`
+- `stock_get`
+- `stock_getById`
 - `search_get`
 
 Full descriptions live on the [main MCP page](./README.md).

package/claude-code.md

@@ -64,11 +64,22 @@ The Moon Banking MCP server exposes the following tools (identical across every
 - `bank_getById`
 - `bank_semanticSearch`
 - `bankVote_get`
+- `bankProduct_list`
+- `bankProduct_listByBank`
+- `bankProduct_create`
+- `bankProduct_listForOwnedBank`
+- `bankProduct_update`
+- `bankProduct_delete`
+- `bankProduct_setStatus`
 - `country_get`
 - `country_getByCountryCode`
 - `story_get`
 - `story_getById`
 - `world_getOverview`
+- `market_get`
+- `market_getById`
+- `stock_get`
+- `stock_getById`
 - `search_get`
 
 Full descriptions live on the [main MCP page](./README.md).

package/claude.md

@@ -85,11 +85,22 @@ The Moon Banking MCP server exposes the following tools (identical across every
 - `bank_getById`
 - `bank_semanticSearch`
 - `bankVote_get`
+- `bankProduct_list`
+- `bankProduct_listByBank`
+- `bankProduct_create`
+- `bankProduct_listForOwnedBank`
+- `bankProduct_update`
+- `bankProduct_delete`
+- `bankProduct_setStatus`
 - `country_get`
 - `country_getByCountryCode`
 - `story_get`
 - `story_getById`
 - `world_getOverview`
+- `market_get`
+- `market_getById`
+- `stock_get`
+- `stock_getById`
 - `search_get`
 
 Full descriptions live on the [main MCP page](./README.md).

package/cursor.md

@@ -76,11 +76,22 @@ The Moon Banking MCP server exposes the following tools (identical across every
 - `bank_getById`
 - `bank_semanticSearch`
 - `bankVote_get`
+- `bankProduct_list`
+- `bankProduct_listByBank`
+- `bankProduct_create`
+- `bankProduct_listForOwnedBank`
+- `bankProduct_update`
+- `bankProduct_delete`
+- `bankProduct_setStatus`
 - `country_get`
 - `country_getByCountryCode`
 - `story_get`
 - `story_getById`
 - `world_getOverview`
+- `market_get`
+- `market_getById`
+- `stock_get`
+- `stock_getById`
 - `search_get`
 
 Full descriptions live on the [main MCP page](./README.md).

package/devin-desktop.md

@@ -0,0 +1,85 @@
+# Moon Banking MCP for Devin Desktop
+
+> Connect Devin Desktop (formerly Windsurf) to the Moon Banking MCP server.
+
+Devin Desktop is the new name for Windsurf. Cognition shipped the rename as an over-the-air update on June 2, 2026 — the IDE, your settings, your extensions, and your existing MCP configuration all carried over automatically. The Agent Command Center is now the default surface (multi-agent Kanban view, Spaces, ACP-based third-party agents), with the classic editor still one click away. The local coding agent has been renamed from **Cascade** to **Devin Local** — same MCP plumbing, ~30% better token efficiency, subagent support, and sandboxing. Cascade itself is end-of-life on July 1, 2026, so new MCP setup should target Devin Local; the configuration below works for both.
+
+Devin Local is built for long-running, multi-file agentic coding tasks — exactly where having reliable external data matters. Wire in the Moon Banking MCP and Devin Local gains live access to the entire Moon Banking dataset (banks, countries, community-rated scores across 14 categories, votes, user stories), so when your agent needs to know about a real bank — its hostname, country rank, crypto-friendliness score, or what users say about its fees — it asks instead of guessing.
+
+Useful for building banking-aware features, generating realistic test fixtures across an entire repo, or simply prompting *"find a crypto-friendly digital bank in Portugal and scaffold a project that integrates with its public services"* while Devin Local does the heavy lifting.
+
+Devin Desktop reads MCP servers from a single global `mcp_config.json` file shared with the legacy Windsurf install. Both remote (HTTP) and stdio transports work, and the same file is picked up by Devin Local *and* Cascade (until Cascade's July 1, 2026 sunset).
+
+## Recommended: hosted (OAuth)
+
+Edit (or create) the global config at `~/.codeium/mcp_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "moonbanking": {
+      "serverUrl": "https://mcp.moonbanking.com/mcp"
+    }
+  }
+}
+```
+
+Restart Devin Desktop. The first request to a Moon Banking tool will trigger an OAuth flow in your browser. After approval, the tools become available to Devin Local (and to Cascade, while it remains).
+
+## Alternative: self-hosted (API key)
+
+```json
+{
+  "mcpServers": {
+    "moonbanking-mcp": {
+      "command": "npx",
+      "args": ["-y", "@moonbanking/mcp-server"],
+      "env": {
+        "MOON_BANKING_API_KEY": "Bearer mb_sk_..."
+      }
+    }
+  }
+}
+```
+
+## Verify the connection
+
+Open Devin Desktop, switch to the **Devin Local** agent (or Cascade, if you have not migrated yet), and head to **Settings → Tools** — `moonbanking` should appear with its tool count. Then ask:
+
+> List the top five banks in Japan by user rating.
+
+## Troubleshooting
+
+- **Server not detected.** Confirm Devin Desktop is reading the right config file: open **Settings → Tools** and use **View Raw Config** to verify the path. The file is `~/.codeium/mcp_config.json` — no `windsurf/` subfolder.
+- **Auth window won't open.** Some Linux distributions require a default browser to be configured (`xdg-settings set default-web-browser ...`).
+- **Still on legacy Windsurf 2.0?** The same `~/.codeium/mcp_config.json` works — Cascade reads it directly, and Devin Desktop will pick it up automatically when the OTA update lands.
+
+
+## Available tools
+
+The Moon Banking MCP server exposes the following tools (identical across every client):
+
+- `bank_getByHostname`
+- `bank_get`
+- `bank_getById`
+- `bank_semanticSearch`
+- `bankVote_get`
+- `bankProduct_list`
+- `bankProduct_listByBank`
+- `bankProduct_create`
+- `bankProduct_listForOwnedBank`
+- `bankProduct_update`
+- `bankProduct_delete`
+- `bankProduct_setStatus`
+- `country_get`
+- `country_getByCountryCode`
+- `story_get`
+- `story_getById`
+- `world_getOverview`
+- `market_get`
+- `market_getById`
+- `stock_get`
+- `stock_getById`
+- `search_get`
+
+Full descriptions live on the [main MCP page](./README.md).