GVRN Incorporation

Returns the full GVRN incorporation workflow guide: the fields collected, the email-verification steps, and the review lifecycle. Also available as the MCP resource gvrn://incorporation/guide.

{
  "type": "object",
  "properties": {}
}

Sends a 6-digit verification code to the given email address. The code is exchanged for a verificationToken via verify_email_otp, and that token authorizes the draft tools. Codes expire after 10 minutes and are rate-limited per email.

{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "maxLength": 320,
      "description": "Email address to verify — the user's real inbox"
    }
  },
  "required": [
    "email"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Verifies a 6-digit email code and returns a verificationToken valid for ~30 minutes. The draft tools require this token. Re-verifying the same email issues a fresh token that still reaches the same drafts.

{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "maxLength": 320,
      "description": "Same email the code was sent to"
    },
    "code": {
      "type": "string",
      "minLength": 4,
      "maxLength": 10,
      "description": "The 6-digit code from the user's inbox"
    }
  },
  "required": [
    "email",
    "code"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Creates a new incorporation request draft bound to the verified email, using any fields provided. Requires a verificationToken from verify_email_otp; every other field is optional. Returns a draftId that identifies the draft for later updates, submission, and status checks.

{
  "type": "object",
  "properties": {
    "verificationToken": {
      "type": "string",
      "description": "Token from verify_email_otp — the draft is bound to this email"
    },
    "companyName": {
      "type": "string",
      "maxLength": 300,
      "description": "Preferred company name"
    },
    "alternativeCompanyNames": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 300
      },
      "maxItems": 10,
      "description": "Fallback company names in priority order"
    },
    "jurisdiction": {
      "type": "string",
      "maxLength": 100,
      "description": "Target jurisdiction, e.g. \"BVI\", \"CAYMAN\", \"PANAMA\" — free text is accepted"
    },
    "entityType": {
      "type": "string",
      "maxLength": 100,
      "description": "e.g. \"LTD\", \"FOUNDATION\", \"LLC\" — free text is accepted"
    },
    "founders": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "fullName": {
            "type": "string",
            "maxLength": 200
          },
          "email": {
            "type": "string",
            "maxLength": 320,
            "description": "Founder's contact email"
          },
          "nationality": {
            "type": "string",
            "maxLength": 100,
            "description": "Nationality or citizenship, free text"
          },
          "role": {
            "type": "string",
            "maxLength": 100,
            "description": "e.g. \"Director\", \"Shareholder\", \"CEO\""
          },
          "shareAmount": {
            "type": "number",
            "minimum": 0,
            "description": "Number of shares allocated to this founder"
          }
        },
        "additionalProperties": false,
        "description": "Founder details — every field optional"
      },
      "maxItems": 50,
      "description": "Founders / shareholders / directors"
    },
    "totalShares": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Total shares to be issued"
    },
    "parValue": {
      "type": "number",
      "minimum": 0,
      "description": "Par value per share"
    },
    "currency": {
      "type": "string",
      "maxLength": 10,
      "description": "Share capital currency, e.g. \"USD\""
    },
    "businessDescription": {
      "type": "string",
      "maxLength": 5000,
      "description": "What the company will do"
    },
    "urgency": {
      "type": "string",
      "maxLength": 500,
      "description": "Timeline constraints, e.g. \"needed before token launch July 1\""
    },
    "notes": {
      "type": "string",
      "maxLength": 10000,
      "description": "Anything else relevant: existing structures, PEP status, special requests"
    }
  },
  "required": [
    "verificationToken"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Adds or corrects fields on an existing draft (patch semantics: only provided fields are changed; array fields are replaced whole). Requires a verificationToken for the email that created the draft. Fails once the draft has been submitted.

{
  "type": "object",
  "properties": {
    "draftId": {
      "type": "string",
      "format": "uuid",
      "description": "Draft id returned by create_incorporation_draft"
    },
    "verificationToken": {
      "type": "string",
      "description": "Token from verify_email_otp for the email that created the draft"
    },
    "companyName": {
      "type": "string",
      "maxLength": 300,
      "description": "Preferred company name"
    },
    "alternativeCompanyNames": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 300
      },
      "maxItems": 10,
      "description": "Fallback company names in priority order"
    },
    "jurisdiction": {
      "type": "string",
      "maxLength": 100,
      "description": "Target jurisdiction, e.g. \"BVI\", \"CAYMAN\", \"PANAMA\" — free text is accepted"
    },
    "entityType": {
      "type": "string",
      "maxLength": 100,
      "description": "e.g. \"LTD\", \"FOUNDATION\", \"LLC\" — free text is accepted"
    },
    "founders": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "fullName": {
            "type": "string",
            "maxLength": 200
          },
          "email": {
            "type": "string",
            "maxLength": 320,
            "description": "Founder's contact email"
          },
          "nationality": {
            "type": "string",
            "maxLength": 100,
            "description": "Nationality or citizenship, free text"
          },
          "role": {
            "type": "string",
            "maxLength": 100,
            "description": "e.g. \"Director\", \"Shareholder\", \"CEO\""
          },
          "shareAmount": {
            "type": "number",
            "minimum": 0,
            "description": "Number of shares allocated to this founder"
          }
        },
        "additionalProperties": false,
        "description": "Founder details — every field optional"
      },
      "maxItems": 50,
      "description": "Founders / shareholders / directors"
    },
    "totalShares": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Total shares to be issued"
    },
    "parValue": {
      "type": "number",
      "minimum": 0,
      "description": "Par value per share"
    },
    "currency": {
      "type": "string",
      "maxLength": 10,
      "description": "Share capital currency, e.g. \"USD\""
    },
    "businessDescription": {
      "type": "string",
      "maxLength": 5000,
      "description": "What the company will do"
    },
    "urgency": {
      "type": "string",
      "maxLength": 500,
      "description": "Timeline constraints, e.g. \"needed before token launch July 1\""
    },
    "notes": {
      "type": "string",
      "maxLength": 10000,
      "description": "Anything else relevant: existing structures, PEP status, special requests"
    }
  },
  "required": [
    "draftId",
    "verificationToken"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Submits a draft for review by the GVRN team and returns the request status. Requires a verificationToken for the email that created the draft, which becomes the contact for the request. Optional fields may be left blank. Irreversible: the draft becomes read-only and a review request is filed with the GVRN team.

{
  "type": "object",
  "properties": {
    "draftId": {
      "type": "string",
      "format": "uuid",
      "description": "Draft id returned by create_incorporation_draft"
    },
    "verificationToken": {
      "type": "string",
      "description": "Token from verify_email_otp"
    }
  },
  "required": [
    "draftId",
    "verificationToken"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Returns the current status of an incorporation request (DRAFT → QUEUED_FOR_REVIEW → UNDER_REVIEW → COMPLETED). Requires a verificationToken for the email that created the draft; requests are only visible to that email.

{
  "type": "object",
  "properties": {
    "draftId": {
      "type": "string",
      "format": "uuid",
      "description": "Draft id returned by create_incorporation_draft"
    },
    "verificationToken": {
      "type": "string",
      "description": "Token from verify_email_otp"
    }
  },
  "required": [
    "draftId",
    "verificationToken"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}