finashopping-mcp

ismaeldosil/finashopping-mcp

3.2

If you are the rightful owner of finashopping-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

FinaShopping MCP Server is designed to facilitate interaction with Uruguayan financial products through Claude Desktop.

Tools
8
Resources
0
Prompts
0

FinaShopping MCP Server

CI codecov npm version License: MIT Node.js Version TypeScript

MCP Server for interacting with Uruguayan financial products from Claude Desktop.

Quick Installation

Option 1: npx (recommended)

Add to your claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "finashopping": {
      "command": "npx",
      "args": ["finashopping-mcp"]
    }
  }
}

Option 2: Global installation

npm install -g finashopping-mcp

Then in claude_desktop_config.json:

{
  "mcpServers": {
    "finashopping": {
      "command": "finashopping-mcp"
    }
  }
}

Option 3: From source

git clone https://github.com/ismaeldosil/finashopping-mcp.git
cd finashopping-mcp
npm install
npm run build

In claude_desktop_config.json:

{
  "mcpServers": {
    "finashopping": {
      "command": "node",
      "args": ["/path/to/finashopping-mcp/dist/index.js"]
    }
  }
}

Available Tools

Loans

ToolDescription
search-loansSearch loans by amount, term, and type
calculate-loan-paymentCalculate monthly payment (French amortization)
compare-loansCompare multiple loans
get-loan-requirementsRequirements to apply

Cards and Insurance

ToolDescription
search-credit-cardsSearch cards by network and cost
search-insurancesSearch insurance by type
search-guaranteesRental guarantee options
get-benefitsBenefits and discounts

Available Resources

URIDescription
finashopping://loansLoan catalog
finashopping://cardsCard catalog
finashopping://insuranceInsurance catalog
finashopping://institutionsFinancial institutions
finashopping://credit/rangesCredit score ranges

Available Prompts

PromptDescription
loan-application-guideStep-by-step guide to apply for a loan
improve-credit-scoreTips to improve your score
product-comparisonDetailed product comparison
financial-faqFAQ about finances in Uruguay

Usage Examples

Once installed, in Claude Desktop you can ask:

  • "Search for personal loans up to $100,000"
  • "Calculate the payment for a $50,000 loan at 24 months with 28% rate"
  • "Compare credit cards with no annual fee"
  • "What do I need to apply for a mortgage?"
  • "Give me tips to improve my credit score"

Environment Variables

VariableDefaultDescription
FINASHOPPING_API_URLhttps://finashopping-backend-production.up.railway.appBackend API URL

Development

# Install dependencies
npm install

# Development
npm run dev

# Build
npm run build

# Tests
npm test

# Type check
npm run type-check

Supported Institutions

Banks

  • BROU (Banco Republica)
  • Santander Uruguay
  • Itau Uruguay
  • Scotiabank Uruguay
  • BBVA Uruguay

Insurance

  • BSE (Banco de Seguros del Estado)
  • Sura Uruguay
  • Mapfre Uruguay

Payment Networks

  • OCA
  • Visa
  • Mastercard

Troubleshooting

Server doesn't appear in Claude Desktop

  1. Verify that claude_desktop_config.json is in the correct location
  2. Restart Claude Desktop completely
  3. Verify that Node.js 20+ is installed

Backend connection error

  1. Check internet connectivity
  2. Backend is at: https://finashopping-backend-production.up.railway.app/health

View MCP Server logs

Logs are written to stderr. In development you can see them in the terminal.

License

MIT

URLs

ServiceURL
Frontendhttps://finashopping-frontend.vercel.app
Backend APIhttps://finashopping-backend-production.up.railway.app
MCP Serverhttps://finashopping-mcp-production.up.railway.app
API Docshttps://finashopping-backend-production.up.railway.app/api-docs

Links