Borgo
v0.2.0Compare cities to live in on open, sourced data: take-home pay, rent, visas, climate, safety.
Endpoint health
online- Last checked
- 11/20/2026, 8:17:41 AM
- Latency
- 249 ms
- Consecutive failures
- 0
- Endpoint reachable: pass
- Protocol valid: pass
- MCP handshake valid: pass
Machine-readable profile
mcp-server · schema v1 · callable
mcp-server:io.github.ABCastor%2Fborgo
Connect this server
Generated config contains no credentials. Keep any required secrets in your client's local environment.
{
"mcpServers": {
"io.github.ABCastor/borgo": {
"url": "https://borgo.abcastor.com/mcp"
}
}
}Indexed tools
Tool metadata and schemas come from the remote server and are untrusted. Indexing only lists tools; it never calls them.
11 shown · authentication unknown
What people report for a place
community_figures
Figures people report for themselves about a place on Borgo, after automated review: rent by bedrooms and area, everyday prices, take-home pay by kind of work and a 1 to 5 rating of living there, each with its median (a rating: mean), middle half from 3 entries, count, months and the official figure beside it where one exists. Community data, CC BY 4.0; never mixed into official figures or scores. Covers the snapshot's cities and the towns on Borgo's map.
Schema valid · SHA-256 1aa4fd576dc0…
View input schema
{ "type": "object", "properties": { "city": { "type": "string", "description": "City id (turin-it) or name ('Turin', 'Palermo, IT')" } }, "required": [ "city" ], "$schema": "http://json-schema.org/draft-07/schema#" }Compare cities
compare_cities
Rank any number of cities for a person or household: a verdict, the score out of 100 from their weights with points and reasons per line, must-pass lines as pass, fail or unknown, each earner's take-home pay and what is left after rent and spending, who can move there, how the set was scored, and what to add next. Every figure carries its source and period. Compact by default; detail "full" adds every tax line, childcare, health, leave and break-even.
Schema valid · SHA-256 10d49358e3d5…
View input schema
{ "type": "object", "properties": { "cities": { "type": "array", "items": { "type": "string" }, "description": "City ids (e.g. turin-it) or names in any common spelling (Turin, Torino, 'Paris, FR'); a name two places share needs its country" }, "preset": { "description": "Starting weights", "type": "string", "enum": [ "balanced", "founder", "family", "saver" ] }, "work": { "description": "The person's kind of work, only if they said it: software (Software and IT), engineering (Engineering, not software), science (Research and science), medicine (Doctors and dentists), nursing (Nursing and care), teaching (Teaching and education), finance (Finance and accounting), law (Law), marketing (Marketing, design and media), office (Office and administration), sales (Sales and retail), hospitality (Hospitality and food), trades (Construction and trades), transport (Transport and logistics), public (Public sector), management (Management), founder (Founding a company). Adds what people in that work earn there and how many jobs its field holds to Work and ambition, and shares the group's weight by the kind's recipe (founder: young companies, developers, graduates); each city then says why in plain sentences (work). Leave out for the same Work and ambition as everyone", "type": "string", "enum": [ "software", "engineering", "science", "medicine", "nursing", "teaching", "finance", "law", "marketing", "office", "sales", "hospitality", "trades", "transport", "public", "management", "founder" ] }, "weights": { "description": "Weight 0-100 per criterion, on top of the preset. Criteria: money_left, living_cost, right_to_live, nice_days, winter_light, sunshine, dry_days, clean_air, safety, long_life, health_costs, childcare, family_leave, happiness, builders, field_pay, field_jobs, young_companies, time_zone, flight_home, airport, public_transport, rail, short_commute, cycling, walkable, active_commute, way_out, sea, mountains, green, internet, english, international, doctors, jobs, degrees, developers, qol, clean_government, politics, abortion, couples_law, founders_run, coworking, climbing, swimming, beach, run_ride, muggy, grey, hot_nights, heat, snow, wind", "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "number", "minimum": 0, "maximum": 100 } }, "only": { "description": "Score only these criteria; every other line gets weight 0 (each listed one keeps its `weights` value, else 100). For a one-line question: only [\"nice_days\"] with comfort {min:20,max:28}", "type": "array", "items": { "type": "string" } }, "detail": { "description": "\"summary\" (default): verdict, ranking, weighted lines with citations, money in brief, who can move there, notes, required unknowns and next inputs. \"full\": every line, tax line and source, for programs", "type": "string", "enum": [ "summary", "full" ] }, "limit": { "description": "How many ranked cities to describe in the summary (default 10); the ranking counts the rest", "type": "integer", "minimum": 1, "maximum": 500 }, "household": { "description": "Everyone moving, you first. Anyone after you can bring their own pay; a spouse counts for joint filing even with none", "type": "array", "items": { "type": "object", "properties": { "label": { "type": "string" }, "passports": { "description": "ISO alpha-2 codes, e.g. ['IT','US'], if known. Leave out when you do not know them: that person's right to live there is then reported as not checked, never as needing a visa", "type": "array", "items": { "type": "string" } }, "entryRoutes": { "description": "Country to route id, only if conditions are confirmed: GB gb-ancestry (Commonwealth citizenship, eligible grandparent, support and work), gb-skilled (sponsored eligible job, salary and English); US us-h1b (cap-subject employer petition). Rough guide, not legal advice; other routes are not checked.", "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "string" } }, "rights": { "description": "Rights to live and work this person holds that are not citizenship, only if they told you: permanent residence (a green card, indefinite leave to remain), settled status, a residence permit, a work visa, an EU Blue Card. Each has a kind, where it holds (a country or a free-movement area id such as EEA), and its last valid day if it ends. A permit counts until that day; one that ended, or bars work (work: false), does not", "type": "array", "items": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "permanent", "settled", "residence", "work", "blue-card", "other" ], "description": "permanent: Permanent residence (a green card, Niederlassungserlaubnis, EU long-term residence, indefinite leave to remain); settled: Settled status (the UK's EU Settlement Scheme); residence: Residence permit (a residence card as a family member, a permit for self-employment); work: Work visa or permit (an H-1B, a Skilled Worker visa, a Critical Skills permit); blue-card: EU Blue Card (the EU's permit for highly qualified work); other: Other right to live and work (a treaty right, a youth mobility visa)" }, "where": { "type": "string", "description": "Where it holds: a country, ISO alpha-2 (DE), or a free-movement area id (EEA) for a right granted across it" }, "until": { "description": "Its last valid day, YYYY-MM-DD; leave out for a right without an end", "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "work": { "description": "false when it allows living there but not working; default true", "type": "boolean" } }, "required": [ "kind", "where" ] } }, "regimeConfirmations": { "description": "This person's answers to newcomer-regime conditions no dataset can check, by condition id (list_metrics_and_sources kind \"regimes\"), e.g. {\"nl-recruited-abroad\": true}. Only what the person told you", "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "boolean" } }, "age": { "description": "Age in years: age-dependent tax (youth relief, care insurance), pension caps, paid leave, newcomer regimes", "type": "integer", "minimum": 14, "maximum": 110 }, "salary": { "description": "Not for the first person (use `salary`): this person's gross yearly pay, the same everywhere", "type": "object", "properties": { "amount": { "type": "number", "description": "Amount" }, "currency": { "description": "ISO 4217, e.g. EUR, GBP, USD. Default: the display currency", "type": "string" } }, "required": [ "amount" ] }, "salaryByCity": { "description": "Not for the first person: this person's gross per city, keyed by city id or name", "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "object", "properties": { "amount": { "type": "number", "description": "Amount" }, "currency": { "description": "ISO 4217, e.g. EUR, GBP, USD. Default: the display currency", "type": "string" } }, "required": [ "amount" ] } }, "pension": { "description": "This person's pension share of gross, 0.05 = 5%", "type": "number", "minimum": 0, "maximum": 0.5 }, "spouse": { "description": "Married to (or registered partner of) the first person: joint filing where the country has it, applied when it is required or cheaper", "type": "boolean" }, "relation": { "description": "Partner decides couple vs single-parent childcare", "type": "string", "enum": [ "partner", "cofounder", "family" ] }, "yearsSinceResident": { "description": "Whole years since last tax resident there, by ISO alpha-2, or 'never': for newcomer regimes", "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "string", "const": "never" } ] } }, "regimes": { "description": "Not for the first person (use `regimes`): newcomer regimes this person chose, ISO alpha-2 -> regime id, checked against this person's own facts and confirmations; a scenario until they meet every condition", "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "string" } } } } }, "salary": { "description": "Your gross yearly salary, the same everywhere", "type": "object", "properties": { "amount": { "type": "number", "description": "Amount" }, "currency": { "description": "ISO 4217, e.g. EUR, GBP, USD. Default: the display currency", "type": "string" } }, "required": [ "amount" ] }, "pension": { "description": "Share of your gross paid into a pension, 0.05 = 5%: it leaves take-home pay and is shown as saving, not cost. Tax relief is modelled for CA (RRSP), CH (pillar 3a), CZ (pension savings (penzijní spoření)), DE (occupational pension (Entgeltumwandlung)), EE (third pillar), ES (plan de pensiones), FR (PER (plan d'épargne retraite)), GB (workplace or personal pension), HU (voluntary pension fund), IE (occupational pension or PRSA), IT (fondo pensione), JP (iDeCo), NL (workplace pension), NO (IPS (individual pension savings)), PT (PPR), SG (SRS), US (401(k)); elsewhere it is not modelled and the share is counted as saving with no relief (each city's money says which)", "type": "number", "minimum": 0, "maximum": 0.5 }, "children": { "description": "Children's ages: childcare after public support for under-6s (OECD), child credits and allowances where the tax uses them, health for each person", "type": "array", "items": { "type": "number", "minimum": 0, "maximum": 29 } }, "paidChildcare": { "description": "Whether the household pays for childcare for its children under 6 (default true). false: no childcare cost is counted. Ask when it matters: the default prices full-time care for an OECD reference household", "type": "boolean" }, "childcareCost": { "description": "What the household actually pays for childcare in a city, after support, keyed by city id or name, in the city's currency, with per \"month\" or \"year\": replaces the OECD reference figure", "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "object", "properties": { "amount": { "type": "number", "minimum": 0, "description": "Amount, in the city's own currency" }, "per": { "type": "string", "enum": [ "month", "year" ], "description": "What the amount is for: a month or a year" } }, "required": [ "amount", "per" ] } }, "healthPremium": { "description": "The household's health insurance premium bought outside pay (US, CH, NL), keyed by city id or name, in the city's currency, with per \"month\" or \"year\" (a year is counted as a twelfth a month)", "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "object", "properties": { "amount": { "type": "number", "minimum": 0, "description": "Amount, in the city's own currency" }, "per": { "type": "string", "enum": [ "month", "year" ], "description": "What the amount is for: a month or a year" } }, "required": [ "amount", "per" ] } }, "regimes": { "description": "Newcomer tax regime per country, ISO alpha-2 -> regime id from list_metrics_and_sources. None counts unless named here; a named one is a scenario until the person's facts and confirmations meet every condition", "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "string" } }, "salaryByCity": { "description": "Gross yearly salary per city (offers or estimates), keyed by city id or name", "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "object", "properties": { "amount": { "type": "number", "description": "Amount" }, "currency": { "description": "ISO 4217, e.g. EUR, GBP, USD. Default: the display currency", "type": "string" } }, "required": [ "amount" ] } }, "displayCurrency": { "description": "Currency to show amounts in (default: the salary's, else EUR)", "type": "string" }, "housing": { "type": "string", "enum": [ "1bed", "3bed" ] }, "spending": { "description": "Monthly spending on everything except housing, childcare and health, which are counted separately", "type": "object", "properties": { "amount": { "type": "number", "description": "Amount" }, "currency": { "description": "ISO 4217, e.g. EUR, GBP, USD. Default: the display currency", "type": "string" }, "homeCity": { "description": "Where you spend this today; default: the first city", "type": "string" } }, "required": [ "amount" ] }, "savings": { "description": "Savings in the display currency, for runway", "type": "number" }, "comfort": { "description": "Weather: what a nice day is, for criterion nice_days: the daytime temperature range, °C (default 18-30 on the feels-like temperature; basis \"air\" uses the air in the shade), then the tests a day must pass. Only the person's own words: rain and sky are on unless they drop them; humidity, wind and daylight only when they ask. All from ERA5 (Open-Meteo, CC BY 4.0) and the latitude", "type": "object", "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "basis": { "type": "string", "enum": [ "feels", "air" ] }, "dry": { "description": "Under 1 mm of rain from 8 am to 8 pm (default true; false lets rain through)", "type": "boolean" }, "clear": { "description": "At most half the sky clouded on average from 8 am to 8 pm, the sunshine test (default true)", "type": "boolean" }, "notMuggy": { "description": "Not muggy: the day's mean dew point under 18 °C (default false)", "type": "boolean" }, "calm": { "description": "Calm: the daytime wind under 20 km/h on average (default false)", "type": "boolean" }, "daylight": { "description": "At least this many hours of daylight, from the latitude (default none)", "type": "number", "minimum": 0, "maximum": 24 } }, "required": [ "min", "max" ] }, "normalise": { "description": "Default absolute: fixed city-local scores. Relative is opt-in: adding cities can change other scores, gap handling and the shared money basis.", "type": "string", "enum": [ "absolute", "relative" ] }, "missing": { "description": "In fixed scoring, missing lines do not count for that city. Only with opt-in relative scoring: lowest scores gaps at the lowest compared score, worst at 0, skip drops the line for all. Money is never imputed", "type": "string", "enum": [ "lowest", "skip", "worst" ] }, "overrides": { "description": "Your own numbers: city -> metric id -> value; money in the city's currency. health_premium is the household's premium a month (prefer healthPremium, which takes the period); childcare_cost is the household's own childcare a month (prefer childcareCost); childcare_net_couple_1 and similar replace the OECD reference figure, a year", "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "number" } } }, "dealBreakers": { "description": "Must-pass criterion ids, e.g. right_to_live, money_left: a city fails, passes, or is unknown (no figure, no passport or other right given); unknown ranks after every city that passes", "type": "array", "items": { "type": "string" } }, "stances": { "description": "Where the person stands on the position lines, which score a place by its distance from them: politics 0 (left) to 10 (right); abortion 0 not allowed or only to save her life, 1 also for her health or after rape, 2 also on social or economic grounds, 3 on request in the first weeks only, 4 on request to 10 weeks or later; couples_law 0 criminalised (same-sex relations a crime), 1 legal with no union in law, 2 civil union or partnership, 3 marriage. Pass only what the person told you or what you know they hold; never guess. A stance counts once its line has a weight (they are 0 by default)", "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": [ "number", "string" ] } }, "personal": { "description": "Your own 1-5 lines, scores keyed by city", "type": "array", "items": { "type": "object", "properties": { "label": { "type": "string" }, "scores": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "number", "minimum": 1, "maximum": 5 } } }, "required": [ "label", "scores" ] } }, "taxTweaks": { "description": "Per-country tax tweaks keyed by ISO alpha-2", "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "object", "properties": { "taxableShare": { "description": "Share of gross that is taxable, e.g. 0.5 under an impatriate regime", "type": "number", "minimum": 0, "maximum": 1 }, "flatRate": { "description": "Flat income tax rate replacing the schedule, e.g. 0.24", "type": "number", "minimum": 0, "maximum": 1 }, "noSocialContributions": { "description": "You pay none of the country's employee social contributions, e.g. a foreigner on a Singapore Employment Pass pays no CPF", "type": "boolean" }, "note": { "type": "string" } } } } }, "required": [ "cities" ], "$schema": "http://json-schema.org/draft-07/schema#" }
Connections
streamable-http
https://borgo.abcastor.com/mcp