home / mcp / finashopping mcp server
Provides access to Uruguayan financial products through an MCP endpoint for Claude Desktop, enabling loan, card, and insurance workflows.
Configuration
View docs{
"mcpServers": {
"ismaeldosil-finashopping-mcp": {
"url": "https://finashopping-mcp-production.up.railway.app",
"headers": {
"FINASHOPPING_API_URL": "https://finashopping-backend-production.up.railway.app"
}
}
}
}The FinaShopping MCP Server lets Claude Desktop interact with Uruguayan financial products. It exposes loans, cards, and insurance data through a dedicated MCP endpoint you can reach from your Claude client, enabling tasks like searching loans, calculating payments, and comparing products without leaving Claude.
Once you have the MCP server available, configure Claude Desktop to connect to it. You can choose among multiple delivery methods: a remote HTTP MCP URL, or a local stdio-based MCP server started on your machine.
- Use the HTTP MCP URL to connect directly to the hosted MCP service. This is the simplest option if you want a ready-to-use remote backend.
- Run a local MCP server instance via stdio. This option is useful if you prefer hosting the MCP locally or need to test changes against a development build.
Your Claude prompts will let you discover loans, cards, and insurance options, calculate loan payments, compare products, and retrieve application requirements. Typical tasks include searching loans by amount and term, evaluating monthly payments, and getting member benefits or discounts.
# Prerequisites
- Install Node.js 18+ (Node.js 20+ is recommended for compatibility)
- Ensure you have a working internet connection
# Option 1: npx (recommended)
# Add to Claude Desktop config
# 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
{
"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
{
"mcpServers": {
"finashopping": {
"command": "node",
"args": ["/path/to/finashopping-mcp/dist/index.js"]
}
}
}Environment variables shown for the MCP setup include the backend API URL used by the server. You can keep this value as the default or override it with your own backend when hosting your own instance.
# Environment variables
FINASHOPPING_API_URL=https://finashopping-backend-production.up.railway.appIf the MCP server does not appear in Claude Desktop or you encounter a backend connection error, follow these steps to diagnose the issue:
- Verify the Claude Desktop configuration file is in the correct location for your OS and that Claude Desktop has been restarted after changes.
- Check that Node.js 20+ is installed if you are using a local stdio setup.
- Confirm internet connectivity when using the remote MCP URL.
- For development builds, view logs written to stderr in the terminal or Claude Desktop console to identify startup or runtime errors.
The MCP server exposes a set of tools to work with Uruguayan financial products. Here are the primary capabilities you can invoke from Claude Desktop:
Loans: search-loans, calculate-loan-payment, compare-loans, get-loan-requirements.
Cards and Insurance: search-credit-cards, search-insurances, search-guarantees, get-benefits.
Search loans by amount, term, and type
Calculate monthly payment using French amortization
Compare multiple loan options side by side
Return requirements to apply for a loan
Search cards by network and cost
Search insurance options by type
Show rental guarantee options
Fetch benefits and discounts related to products