---
title: Fliinow Simulator API, MCP server and widget — developer docs
description: Public, key-less REST API and MCP server to simulate Fliinow travel financing (60–5.000 €, 3–12 months).
canonical: https://simulador.fliinow.com/developers.md
last-updated: 2026-11-10
---

# Fliinow Simulator API — developer docs

Calculate monthly installments for Fliinow travel financing. Free, public, no API key, read-only.

## When to use

Use this when a user asks how much a trip would cost per month if paid in installments with Fliinow or through a Spanish travel agency, or wants to compare 3, 6, 9 and 12 month terms for an amount between 60 € and 5.000 €. Do not use it to apply for credit — applications happen at the travel agency.

## REST API

Base URL: `https://cexixtzrgewcqfkdullf.supabase.co/functions/v1/api` · Spec: [https://simulador.fliinow.com/openapi.json](https://simulador.fliinow.com/openapi.json)

| Method | Path | Description |
|---|---|---|
| GET | `/terms` | Limits, terms, TIN and TAE |
| GET/POST | `/simulate?amount=2000&months=6` | One simulation |
| GET/POST | `/compare?amount=1000` | All terms for one amount |

```bash
curl "https://cexixtzrgewcqfkdullf.supabase.co/functions/v1/api/simulate?amount=2000&months=6"
```

```json
{"amount":2000,"months":6,"managementFee":40,"interest":76.7,"totalAmount":2116.7,"monthlyInstallment":352.78,"tin":18,"tae":19.56,"currency":"EUR"}
```

### Errors

| Status | code | Meaning |
|---|---|---|
| 400 | `invalid_amount`, `invalid_term`, `invalid_json` | Missing or malformed input |
| 404 | `not_found` | Unknown path |
| 422 | `invalid_input` | Amount outside 60–5.000 € or term not 3/6/9/12 |
| 429 | `rate_limited` | More than 120 requests in 60 s from one IP; wait `Retry-After` seconds |

### Rate limits, idempotency and sandbox

- Every response carries IETF `RateLimit` / `RateLimit-Policy` headers (120 requests per 60 s per IP) plus `Retry-After` on 429.
- POST endpoints accept an optional `Idempotency-Key` header. All operations are pure calculations, so repeated requests always return the same result and never create anything.
- Sandbox: the API is stateless and has no side effects, so the production URL is safe to test against — no keys, test mode or test data needed.

## MCP server

Streamable HTTP, no auth: `https://cexixtzrgewcqfkdullf.supabase.co/functions/v1/mcp`

Tools (all read-only, with output schemas): `simulate_financing(amount, months)`, `compare_terms(amount)`, `get_financing_conditions()`, and the documentation tools `search_guides(query)` and `get_guide(slug)`. Server card: https://simulador.fliinow.com/.well-known/mcp/server-card.json

## In-browser (WebMCP)

Pages on https://simulador.fliinow.com register `simulate_financing`, `compare_terms`, `get_financing_conditions` and `show_simulation` (loads values into the on-page simulator) through `document.modelContext.registerTool()`.

## Widget

Embed the simulator on any website: [https://simulador.fliinow.com/integrar](https://simulador.fliinow.com/integrar).

## Public repository

Install instructions for Claude, ChatGPT, Cursor and VS Code, the MCP registry listing (`server.json`), a Claude Code plugin and the agent skill: [https://github.com/Fliinow/simulador-mcp](https://github.com/Fliinow/simulador-mcp)

## Agent skill

[https://simulador.fliinow.com/.well-known/agent-skills/fliinow-simulator/SKILL.md](https://simulador.fliinow.com/.well-known/agent-skills/fliinow-simulator/SKILL.md)

## Markdown twins and data feeds

- Guides as markdown: `https://simulador.fliinow.com/guias/<slug>.md` · installment tables: [/financiar.md](https://simulador.fliinow.com/financiar.md)
- NLWeb schema feeds: [/schemamap.xml](https://simulador.fliinow.com/schemamap.xml) → `/feeds/simulations.jsonl`, `/feeds/guides.jsonl`
- Agent plugin manifest: [/plugin.json](https://simulador.fliinow.com/plugin.json)
