FinaShopping MCP Server
Provides access to Uruguayan financial products including MasterCard credit cards, enabling search and comparison of cards by network and cost.
Provides access to Uruguayan financial products including Visa credit cards, enabling search and comparison of cards by network and cost.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@FinaShopping MCP Server search for personal loans up to $100,000"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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-mcpThen 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 buildIn claude_desktop_config.json:
{
"mcpServers": {
"finashopping": {
"command": "node",
"args": ["/path/to/finashopping-mcp/dist/index.js"]
}
}
}Available Tools
Loans
Tool | Description |
| Search loans by amount, term, and type |
| Calculate monthly payment (French amortization) |
| Compare multiple loans |
| Requirements to apply |
Cards and Insurance
Tool | Description |
| Search cards by network and cost |
| Search insurance by type |
| Rental guarantee options |
| Benefits and discounts |
Available Resources
URI | Description |
| Loan catalog |
| Card catalog |
| Insurance catalog |
| Financial institutions |
| Credit score ranges |
Available Prompts
Prompt | Description |
| Step-by-step guide to apply for a loan |
| Tips to improve your score |
| Detailed product comparison |
| 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 |
|
| Backend API URL |
Development
# Install dependencies
npm install
# Development
npm run dev
# Build
npm run build
# Tests
npm test
# Type check
npm run type-checkSupported 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
Verify that
claude_desktop_config.jsonis in the correct locationRestart Claude Desktop completely
Verify that Node.js 20+ is installed
Backend connection error
Check internet connectivity
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 | |
Backend API | |
MCP Server | |
API Docs | https://finashopping-backend-production.up.railway.app/api-docs |
Links
Available Tools
9 toolscalculate-loan-paymentA
Calculate monthly loan payment using the French amortization system (fixed payment). Returns payment, total amount, and interest. | Calcular la cuota mensual de un préstamo usando el sistema francés (cuota fija). Devuelve cuota, total a pagar e intereses.
Inputs: amount (required), rate (required), term (required).
compare-loansB
Compare multiple loans side by side. Useful for choosing the best option. | Comparar múltiples préstamos lado a lado. Útil para elegir la mejor opción.
Inputs: loanIds (required).
get-benefitsC
Get available benefits and discounts for financial product users. | Obtener beneficios y descuentos disponibles para usuarios de productos financieros.
Inputs: category.
get-card-detailsC
Get complete details for a specific credit card. | Obtener detalles completos de una tarjeta de crédito específica.
Inputs: cardId (required).
get-loan-requirementsC
Get the requirements to apply for a specific loan. | Obtener los requisitos para solicitar un préstamo específico.
Inputs: loanId (required).
search-credit-cardsB
Search available credit cards in Uruguay. Filter by payment network and maximum annual fee. | Buscar tarjetas de crédito disponibles en Uruguay. Filtrar por red de pago y costo anual máximo.
Inputs: network, maxAnnualFee.
search-guaranteesC
Search available rental guarantee options in Uruguay. | Buscar opciones de garantía de alquiler disponibles en Uruguay.
Inputs: no named parameters.
search-insurancesC
Search available insurance in Uruguay. Includes life, auto, home insurance and more. | Buscar seguros disponibles en Uruguay. Incluye seguros de vida, auto, hogar y más.
Inputs: type.
search-loansC
Search available loans from Uruguayan financial institutions. Filter by amount, term, and type. | Buscar préstamos disponibles en instituciones financieras uruguayas. Filtrar por monto, plazo y tipo.
Inputs: amount, term, type.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 9 tools
Most tools have distinct purposes targeting different financial products (loans, credit cards, guarantees, insurances, benefits), but 'search-loans' and 'compare-loans' could cause some confusion as both involve loan evaluation. Descriptions help clarify that 'search-loans' finds available options while 'compare-loans' analyzes multiple loans side-by-side.
All tool names follow a consistent verb_noun pattern with hyphens (e.g., calculate-loan-payment, search-credit-cards). The naming is predictable and readable throughout, with no mixing of conventions or styles.
With 9 tools, the server is well-scoped for a financial shopping assistant covering loans, credit cards, guarantees, insurances, and benefits. Each tool earns its place by addressing a specific aspect of financial product research and comparison in Uruguay.
The tool set provides strong coverage for searching and comparing financial products, with minor gaps. For example, there are tools to search loans and credit cards but no explicit tools for applying or managing these products, which agents might need to work around. However, core research workflows are well-supported.
Related MCP Connectors
Credit payment and amortization calculations, editorial sources and simulator discovery.
India's financial MCP — cards, loans, FDs, insurance, MFs; EMI/SIP/tax calcs; NAV lookup; RAG.
Brazilian Open Finance MCP — 30+ banks (Itaú, Nubank, etc.) to Claude/Cursor. Read-only.
Broker-only credit/lending discovery shim for AI agents