solooutpost-mcp

MCP server for the SoloOutpost Visa & Tax API. It gives Claude, Cursor, and any other MCP client direct tools to answer relocation questions: for any passport, where you can live and how you get to stay, plus the full tax and cost picture for ~150 countries.

Read-only. No API key needed for the public endpoints.

Tools

• list_nationalities — every passport covered (discover valid inputs).
• mobility_by_passport — every country a nationality can relocate to, ranked by Solopreneur Friendliness, with the visa route that applies. Args: nationality (e.g. russian), optional nomad (bool), optional max_income (USD/month).
• list_countries — all countries with headline tax fields and scores.
• country_profile — full tax, cost, and visa record for one country (e.g. portugal).

Install

Claude Code

claude mcp add solooutpost -- npx -y solooutpost-mcp

Claude Desktop

Add to claude_desktop_config.json (Settings → Developer → Edit Config):

{
  "mcpServers": {
    "solooutpost": {
      "command": "npx",
      "args": ["-y", "solooutpost-mcp"]
    }
  }
}

Cursor

Add to ~/.cursor/mcp.json (or the project's .cursor/mcp.json):

{
  "mcpServers": {
    "solooutpost": {
      "command": "npx",
      "args": ["-y", "solooutpost-mcp"]
    }
  }
}

Restart the client and ask something like: "Using SoloOutpost, where can a Russian freelancer live on a digital nomad visa under $3,000 a month?"

Configuration

• SOLOOUTPOST_API_BASE — override the backend base URL (defaults to https://solooutpost.com/api).

Links

• API docs: https://solooutpost.com/developers
• OpenAPI spec: https://solooutpost.com/api/openapi.yaml
• LLM summary: https://solooutpost.com/llms.txt

MIT licensed.