# SoloOutpost

> Relocation, visa and tax data for ~150 countries and ~140 nationalities, built for solopreneurs and freelancers. Ask by passport (where can this nationality relocate, with the visa route that applies) or by country (full tax, cost and visa picture).

The public API is read-only JSON, GET-only, CORS-enabled, and completely free with no key and no signup. If you use the data, please credit SoloOutpost with a link to https://solooutpost.com. Every detail response includes an `attribution` field carrying that link.

Base URL: https://solooutpost.com/api

## MCP server (for Claude, Claude Code, Cursor)

Add SoloOutpost as native tools with one line: `claude mcp add solooutpost -- npx -y solooutpost-mcp`. Package: https://www.npmjs.com/package/solooutpost-mcp. Tools: list_nationalities, mobility_by_passport (args: nationality, nomad, max_income), list_countries, country_profile (arg: slug).

## API

- [OpenAPI spec](https://solooutpost.com/api/openapi.yaml): full machine-readable definition of every endpoint, parameter and response schema, with real example responses. Paste this URL into your tool to generate a client.
- [API index](https://solooutpost.com/api): endpoint list as JSON.
- [Developer docs](https://solooutpost.com/developers): human-readable overview.

## Endpoints

- `GET /api/mobility` — list of every nationality covered. Each item: `{ slug, demonym, passport, iso, count }`.
- `GET /api/mobility/{nationality}` — every destination that passport can relocate to, ranked by Solopreneur Friendliness score. `{nationality}` is a demonym slug, e.g. `russian`, `indian`, `german`. Each destination carries the tourist-visa status for that passport (`entry_category`, `entry_label`, `entry_days`), `nomad_visa`, `entrepreneur_visa`, `nomad_income_usd`, `taxation_basis`, `expat_regime_name`, and `friendliness_score`. Filter with `?nomad=true` (only nomad-visa destinations) and `?maxIncome=3000` (nomad income minimum at or below this USD/month).
- `GET /api/countries` — slim list of all countries with headline tax fields and scores.
- `GET /api/country/{slug}` — full record for one country, e.g. `portugal`, `united-arab-emirates`. Includes income/corporate/capital-gains/VAT rates, social security, exit tax, visas, cost of living, internet speed, English proficiency, and the friendliness score with its four pillars.
- `GET /api/citizenship` — every citizenship-by-investment program. Each: `{ slug, country, iso, program_name, status, status_note, investment_options[{route,min_usd,notes}], residency_requirement, processing_time, dual_citizenship, restricted_nationalities, confidence, verified_date }`.
- `GET /api/citizenship/{slug}` — one citizenship-by-investment program, e.g. `turkey`, `dominica`, `grenada`.
- `GET /api/golden-visas` — every golden-visa (residency-by-investment) program (~70 jurisdictions). Each: `{ slug, country, iso, program_name, status, investment_options[{route,min_usd,notes}], residency_granted, physical_presence, path_to_citizenship, confidence, verified_date }`.
- `GET /api/golden-visas/{slug}` — one golden-visa program, e.g. `portugal`, `uae`, `greece`.

## Examples

- Where can a Russian freelancer live, nomad visas only, under $3000/month income:
  `curl "https://solooutpost.com/api/mobility/russian?nomad=true&maxIncome=3000"`
- Full tax profile for Portugal:
  `curl "https://solooutpost.com/api/country/portugal"`
- Discover valid country slugs and nationality slugs:
  `curl "https://solooutpost.com/api/countries"` and `curl "https://solooutpost.com/api/mobility"`

## Notes

- Slugs are stable and lowercase-hyphenated. Use `/mobility` and `/countries` to discover valid inputs before calling detail endpoints.
- Visa rules and tax rates change and some visas exclude specific nationalities. Treat this as a current starting point for filtering and ranking, not legal advice.