mirabelloconsultancy-com Programmes API

openapi: 3.2.0
info:
  title: Mirabello Immigration Intelligence Programmes API
  version: 1.4.1
  x-logo:
    url: https://mcp.mirabelloconsultancy.com/icon.png
  description: Read-only REST mirror of the Mirabello MCP server — an investment-migration intelligence layer covering 190+ countries. CBI/RBI programmes, cost estimates, passport mobility, per-country residence/citizenship pathways and HNWI tax snapshots. Indicative data; not legal/financial advice. © Mirabello Consultancy Ltd.
  contact:
    name: Mirabello Consultancy
    url: https://www.mirabelloconsultancy.com
    email: mail@mirabelloconsultancy.com
  x-mcp-endpoint: https://mcp.mirabelloconsultancy.com/
servers:
- url: https://mcp.mirabelloconsultancy.com/v1
tags:
- name: Programmes
paths:
  /programmes:
    get:
      operationId: listProgrammes
      summary: List CBI/RBI programmes (filterable).
      parameters:
      - name: type
        in: query
        schema:
          type: string
          enum:
          - CBI
          - RBI
        description: 'Programme family: "CBI" grants citizenship, "RBI" grants residence (golden visa). Omit for both.'
        example: CBI
      - name: budget_max
        in: query
        schema:
          type: number
        description: Maximum headline minimum investment the applicant will consider, in USD. Programmes with no fixed threshold are excluded from budget filtering.
        example: 250000
      - name: region
        in: query
        schema:
          type: string
        description: Region filter, matched case-insensitively (e.g. "Caribbean", "EU", "Middle East", "Pacific", "Africa", "Asia").
        example: Caribbean
      - name: max_processing_months
        in: query
        schema:
          type: number
        description: Maximum acceptable processing time in MONTHS, compared against the lower bound of each programme's published range.
        example: 6
      responses:
        '200':
          description: Matching programmes
      tags:
      - Programmes
  /programmes/{id}:
    get:
      operationId: getProgramme
      summary: Full detail for one programme
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
        description: Programme id as returned by list_programmes (e.g. "dominica-cbi", "greece-gv") or an unambiguous name ("Dominica", "Portugal golden visa"); an ambiguous name returns the candidates.
        example: dominica-cbi
      responses:
        '200':
          description: Programme detail
        '404':
          description: Not found — the id could not be resolved. The body carries did_you_mean with the closest valid ids.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - Programmes
  /programmes/{id}/cost:
    get:
      operationId: estimateTotalCost
      summary: Estimate total cost for a family
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
        description: Programme id as returned by list_programmes (e.g. "dominica-cbi", "greece-gv") or an unambiguous name ("Dominica", "Portugal golden visa"); an ambiguous name returns the candidates.
        example: dominica-cbi
      - name: adults
        in: query
        schema:
          type: number
        description: Number of adult applicants including the main applicant.
        example: 2
      - name: children_16plus
        in: query
        schema:
          type: number
        description: Number of dependent children aged 16 or over — usually priced higher than under-16s.
        example: 1
      - name: children_under16
        in: query
        schema:
          type: number
        description: Number of dependent children aged under 16 — priced separately by most Caribbean programmes.
        example: 1
      responses:
        '200':
          description: Indicative cost estimate
        '404':
          description: Not found — the id could not be resolved. The body carries did_you_mean with the closest valid ids.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - Programmes
  /programmes/{id}/visa-free:
    get:
      operationId: checkVisaFree
      summary: Passport mobility for a programme
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
        description: Programme id as returned by list_programmes (e.g. "dominica-cbi", "greece-gv") or an unambiguous name ("Dominica", "Portugal golden visa"); an ambiguous name returns the candidates.
        example: dominica-cbi
      responses:
        '200':
          description: Mobility detail
        '404':
          description: Not found — the id could not be resolved. The body carries did_you_mean with the closest valid ids.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - Programmes
components:
  schemas:
    Error:
      type: object
      description: Error envelope. A wrong programme id returns did_you_mean with the closest real ids.
      properties:
        error:
          type: string
          description: What went wrong, in plain words.
        did_you_mean:
          type: array
          items:
            type: string
          description: Closest valid programme ids, when the id could not be resolved.