@moonbanking/mcp-server 1.2.0 → 1.7.0

package/vscode.md

@@ -0,0 +1,79 @@
+# Moon Banking MCP for VS Code
+
+> Connect VS Code (with GitHub Copilot Chat MCP support) to the Moon Banking MCP server.
+
+GitHub Copilot's MCP support turns VS Code into a coding agent that can talk to live external data — not just whatever was in its training set. With the Moon Banking MCP plugged in, Copilot can answer questions about specific banks while you code: names, hostnames, country rank, community-rated scores across 14 categories (customer service, fees & pricing, digital experience, crypto friendliness, lending, …), and the user stories behind those scores.
+
+Useful when you're integrating with a bank's API, validating hostnames in code, shipping a feature that displays real bank ratings, or just asking *"which banks in Mexico score highest on digital experience?"* in the middle of a session — Copilot will route the question through the MCP server and reply with citable data.
+
+Recent versions of VS Code expose MCP servers to GitHub Copilot Chat via an `mcp.json` configuration. Both remote HTTP and stdio transports are supported.
+
+## Recommended: hosted (OAuth)
+
+Create `.vscode/mcp.json` in your workspace (or the user-level equivalent) and add:
+
+```json
+{
+  "servers": {
+    "moonbanking": {
+      "type": "http",
+      "url": "https://mcp.moonbanking.com/mcp"
+    }
+  }
+}
+```
+
+Reload the window. The first time Copilot Chat invokes a Moon Banking tool, VS Code will pop a notification asking you to authenticate in your browser. After approval, the connection is reused for the rest of the session.
+
+## Alternative: self-hosted (API key)
+
+```json
+{
+  "servers": {
+    "moonbanking-mcp": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@moonbanking/mcp-server"],
+      "env": {
+        "MOON_BANKING_API_KEY": "Bearer mb_sk_..."
+      }
+    }
+  }
+}
+```
+
+## Verify the connection
+
+Open Copilot Chat and ask:
+
+> @workspace Using the Moon Banking MCP, find me three banks in France that score highly on digital experience.
+
+If the tools are connected, Copilot will reply with tool-call traces visible in the chat view.
+
+## Troubleshooting
+
+- **VS Code doesn't see the config.** Confirm you are on a recent version of VS Code (MCP support shipped in late 2025 / 2026). Older versions don't honor `mcp.json`.
+- **Auth never completes.** Make sure VS Code is allowed to open external URLs (`window.openUrl` setting). Corporate proxies may block the OAuth callback.
+
+
+## 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`
+- `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/zed.md

@@ -0,0 +1,76 @@
+# Moon Banking MCP for Zed
+
+> Connect the Zed editor to the Moon Banking MCP server via Context Servers.
+
+Zed's AI assistant is fast and stays out of your way — exactly what you want when you're moving through code. Connecting the Moon Banking MCP gives that assistant live access to the Moon Banking dataset: every bank, country, community-rated score across 14 categories (customer service, fees & pricing, digital experience, crypto friendliness, lending, …), vote, and user story. Questions about real banks come back with real data, with no perceptible latency hit on the rest of your workflow.
+
+Useful for scaffolding fintech projects, generating realistic test data, or just pulling up *"the five highest-rated business banks in Canada"* or *"which European banks have the best digital experience scores?"* without leaving the editor.
+
+Zed exposes MCP servers to its built-in AI assistant as **Context Servers**. Configure them in `~/.config/zed/settings.json` (or **Zed → Settings → Open settings**).
+
+## Recommended: hosted (OAuth)
+
+```json
+{
+  "context_servers": {
+    "moonbanking": {
+      "command": "npx",
+      "args": ["-y", "mcp-remote", "https://mcp.moonbanking.com/mcp"]
+    }
+  }
+}
+```
+
+Zed's Context Servers currently expect a stdio command, so we wrap the hosted endpoint with [`mcp-remote`](https://www.npmjs.com/package/mcp-remote) — a tiny bridge that proxies stdio to remote Streamable HTTP and handles the OAuth flow in a browser tab.
+
+After saving, restart Zed. The first request to a Moon Banking tool opens a browser window for sign-in.
+
+## Alternative: self-hosted (API key)
+
+```json
+{
+  "context_servers": {
+    "moonbanking-mcp": {
+      "command": "npx",
+      "args": ["-y", "@moonbanking/mcp-server"],
+      "env": {
+        "MOON_BANKING_API_KEY": "Bearer mb_sk_..."
+      }
+    }
+  }
+}
+```
+
+## Verify the connection
+
+Open the Zed AI panel. The **Context Servers** section in the side panel should list `moonbanking` along with its tool count. Then ask:
+
+> Using Moon Banking, what are the most highly-rated banks in Brazil?
+
+## Troubleshooting
+
+- **`mcp-remote` is slow on first run.** It downloads on first invocation. Subsequent runs are cached.
+- **Auth never completes.** Confirm that `localhost` is reachable from your browser — `mcp-remote` uses a local callback port (`http://127.0.0.1:6274` by default).
+
+
+## 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`
+- `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).