FinaShopping MCP Server

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

Tool	Description
search-loans	Search loans by amount, term, and type
calculate-loan-payment	Calculate monthly payment (French amortization)
compare-loans	Compare multiple loans
get-loan-requirements	Requirements to apply

Cards and Insurance

Tool	Description
search-credit-cards	Search cards by network and cost
search-insurances	Search insurance by type
search-guarantees	Rental guarantee options
get-benefits	Benefits and discounts

Available Resources

URI	Description
finashopping://loans	Loan catalog
finashopping://cards	Card catalog
finashopping://insurance	Insurance catalog
finashopping://institutions	Financial institutions
finashopping://credit/ranges	Credit score ranges

Available Prompts

Prompt	Description
loan-application-guide	Step-by-step guide to apply for a loan
improve-credit-score	Tips to improve your score
product-comparison	Detailed product comparison
financial-faq	FAQ 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

Variable	Default	Description
FINASHOPPING_API_URL	https://finashopping-backend-production.up.railway.app	Backend 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

Service	URL
Frontend	https://finashopping-frontend.vercel.app
Backend API	https://finashopping-backend-production.up.railway.app
MCP Server	https://finashopping-mcp-production.up.railway.app
API Docs	https://finashopping-backend-production.up.railway.app/api-docs

Links

• FinaShopping Web
• Backend API Docs
• MCP Protocol
• GitHub Repo