mcp

The Moon Banking MCP server exposes a collection of endpoints to interact with Moon Banking data, following the MCP (Model Context Protocol) standard. It is generated from the OpenAPI specification for Moon Banking and provides tools to retrieve and filter information about banks, countries, stories, and votes, as well as global overview data. When running the server, you can tailor which tools are exposed using the --tool flag, for example to enable only specific endpoints you need. Typical usage involves authenticating with an API key via the MOON_BANKING_API_KEY environment variable and then invoking the available MCP endpoints through a client that supports the MCP protocol. The server supports common endpoints like bank_get, bank_getById, country_get, story_get, world_getOverview, and search_get, along with their variants that allow pagination, filtering, and inclusion of related data such as scores and country information.

Prerequisites:

• Node.js and npm (or npx) installed on your machine
• Access to the Moon Banking OpenAPI-based MCP server package: @moonbanking/mcp-server

Installation steps:

1. Ensure Node.js is installed. You can verify with: node -v npm -v

2. Install or run directly via npx (no global install required): export MOON_BANKING_API_KEY="Bearer your_api_key_here" npx -y @moonbanking/mcp-server

3. If you prefer to pin a version or configure for a client, you can create an MCP config JSON like: { "mcpServers": { "moonbanking-mcp": { "command": "npx", "args": ["-y", "@moonbanking/mcp-server"], "env": { "MOON_BANKING_API_KEY": "Bearer your_api_key_here" } } } }

4. For Cursor or Claude Code integrations, follow their respective setup guides and supply the same MOON_BANKING_API_KEY in the environment configuration.

Note: Replace Bearer your_api_key_here with your actual API key or token. Ensure the API key has the necessary permissions to access Moon Banking MCP endpoints.

Tips and known considerations:

• The API key must be provided via MOON_BANKING_API_KEY in the environment when starting the MCP server.
• Use the --tool flag to limit exposure to only the endpoints you need, e.g., --tool=bank_get --tool=bank_getById.
• Make sure to keep the MCP server up to date with the latest @moonbanking/mcp-server package to benefit from new endpoints and security fixes.
• If integrating with clients like Cursor or Claude Code, configure their respective settings pages (mcp.json or Claude config) to supply the environment variable and the npx command as shown above.
• When testing pagination endpoints (bank_get, country_get, story_get), you can adjust page sizes and filters to control the volume of data returned per request.