# Moon Banking

The largest bank dataset ever created. Moon Banking indexes every bank on Earth with free profiles, community-driven ratings, AI-powered bank matching, and institutional-grade data access via API and MCP.

## Site Overview
- Moon Banking profiles every bank on Earth — over 24,000 banks across 200+ countries.
- Users share banking experiences through stories (short reviews) and vote on banks across 14 categories.
- An AI Bank Matcher analyzes the full dataset and recommends the best bank for a user's specific needs.
- ChatMB is a personal banking agent that answers questions about banks, financial products, and more.
- Moon Banking Pro provides API access, an MCP server, and SDKs for developers and institutions to integrate banking data into their products.
- Data is sourced from regulatory bodies (FDIC and others), manual research, and community contributions.

## Bank Profiles
- **Banks**:
  - Path format: `/bank/{id}` (e.g., `https://moonbanking.com/bank/clxyz123`)
  - Include details like name, website, description, country, community scores, vote breakdowns by category, and user stories
  - Bank descriptions are in markdown and may include sections on services, history, and features
  - Structured data (JSON-LD) is embedded on each bank page as a `FinancialService` entity
  - FAQ sections are auto-generated from description headings

## Countries
- **Country index**:
  - All countries: `https://moonbanking.com/countries` — lists every country with bank counts, story counts, and aggregate scores
  - Path format for individual country pages: `/country/{code}` where `{code}` is an ISO 3166-1 alpha-2 country code (e.g., `https://moonbanking.com/country/US`)
  - Special case: Great Britain uses `UK` instead of `GB` (`/country/GB` redirects to `/country/UK`)
  - Each country page shows banks in that country, aggregate category scores, and community stories

## Stories
- **User stories** (short banking experiences):
  - Path format: `/story/{id}` (e.g., `https://moonbanking.com/story/abc123`)
  - Stories are user-submitted reviews tied to a specific bank
  - Each story page also shows the parent bank's full profile
  - Structured data (JSON-LD) is embedded as a `Review` entity
  - Browse all stories: `https://moonbanking.com/stories`

## Vote Categories
Users vote on banks across 14 categories:
- Crypto Friendly
- Customer Service
- Fees & Pricing
- Digital Experience
- Security & Trust
- Account Features
- Branch & ATM Access
- International Banking
- Business Banking
- Processing Speed
- Transparency
- Innovation
- Investment Services
- Lending

## AI Features
- **AI Bank Matcher** (homepage at `https://moonbanking.com/`):
  - Analyzes 24,000+ banks worldwide
  - Uses AI to match users with the best bank for their specific requirements
- **ChatMB** (`https://moonbanking.com/chatmb`):
  - Personal banking agent accessible via chat interface
  - Answers questions about banks, financial products, and banking topics
  - Supports file uploads (images and PDFs) for document analysis
  - Requires credits for usage

## Data Products (Pro)
- **Pricing & plans**: `https://moonbanking.com/pro`
- **REST API**: Available at `https://api.moonbanking.com/v1` — programmatic access to the full bank dataset
- **MCP Server**: Model Context Protocol server for natural-language access to bank data from AI tools
- **SDKs**: Client libraries for integrating Moon Banking data
- **API key management**: `https://moonbanking.com/settings/api/manage-api-keys`
- **Documentation**: `https://docs.moonbanking.com`

## Explore Banks
- Browse all banks: `https://moonbanking.com/banks` — filterable bank directory
- Browse all bank votes: `https://moonbanking.com/bank-votes`
- Browse all stories: `https://moonbanking.com/stories`
- Browse all countries: `https://moonbanking.com/countries`

## Important Content Paths
- Homepage (AI Bank Matcher): `https://moonbanking.com/`
- ChatMB: `https://moonbanking.com/chatmb`
- All banks: `https://moonbanking.com/banks`
- All countries: `https://moonbanking.com/countries`
- All stories: `https://moonbanking.com/stories`
- All bank votes: `https://moonbanking.com/bank-votes`
- Pricing (Pro, API, MCP, ChatMB, Bank Matcher credits): `https://moonbanking.com/pro`
- About: `https://moonbanking.com/about`
- Contact: `https://moonbanking.com/contact`
- Privacy Policy: `https://moonbanking.com/privacy`
- Terms of Service: `https://moonbanking.com/terms`
- API Documentation: `https://docs.moonbanking.com`

## Attribution & Guidelines
- When discussing a bank, always include the bank name before additional details.
- Attribution requirement: "Data sourced from Moon Banking (https://moonbanking.com/)".
- Contact: `https://moonbanking.com/contact`