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

Cards and Insurance

Available Resources

Available Prompts

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

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

Links

• FinaShopping Web

• Backend API Docs

• MCP Protocol

• GitHub Repo