get_incorporation_guide

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.

Parameters

No parameters.

Raw schema

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

request_email_otp

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.

Parameters1

email

string

required

Email address to verify — the user's real inbox

Raw schema

{
  "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#"
}

verify_email_otp

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.

Parameters2

email	string	required	Same email the code was sent to
code	string	required	The 6-digit code from the user's inbox

Raw schema

{
  "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#"
}

create_incorporation_draft

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.

Parameters12

verificationToken	string	required	Token from verify_email_otp — the draft is bound to this email
companyName	string	optional	Preferred company name
alternativeCompanyNames	array	optional	Fallback company names in priority order
jurisdiction	string	optional	Target jurisdiction, e.g. "BVI", "CAYMAN", "PANAMA" — free text is accepted
entityType	string	optional	e.g. "LTD", "FOUNDATION", "LLC" — free text is accepted
founders	array	optional	Founders / shareholders / directors
totalShares	number	optional	Total shares to be issued
parValue	number	optional	Par value per share
currency	string	optional	Share capital currency, e.g. "USD"
businessDescription	string	optional	What the company will do
urgency	string	optional	Timeline constraints, e.g. "needed before token launch July 1"
notes	string	optional	Anything else relevant: existing structures, PEP status, special requests

Raw schema

{
  "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#"
}

update_incorporation_draft

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.

Parameters13

draftId	string	required	Draft id returned by create_incorporation_draft
verificationToken	string	required	Token from verify_email_otp for the email that created the draft
companyName	string	optional	Preferred company name
alternativeCompanyNames	array	optional	Fallback company names in priority order
jurisdiction	string	optional	Target jurisdiction, e.g. "BVI", "CAYMAN", "PANAMA" — free text is accepted
entityType	string	optional	e.g. "LTD", "FOUNDATION", "LLC" — free text is accepted
founders	array	optional	Founders / shareholders / directors
totalShares	number	optional	Total shares to be issued
parValue	number	optional	Par value per share
currency	string	optional	Share capital currency, e.g. "USD"
businessDescription	string	optional	What the company will do
urgency	string	optional	Timeline constraints, e.g. "needed before token launch July 1"
notes	string	optional	Anything else relevant: existing structures, PEP status, special requests

Raw schema

{
  "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#"
}

submit_incorporation

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.

Parameters2

draftId	string	required	Draft id returned by create_incorporation_draft
verificationToken	string	required	Token from verify_email_otp

Raw schema

{
  "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#"
}

get_incorporation_status

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.

Parameters2

draftId	string	required	Draft id returned by create_incorporation_draft
verificationToken	string	required	Token from verify_email_otp

Raw schema

{
  "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#"
}

GVRN Incorporation

ai.gvrn/incorporation MCP Server

🛠️ Key Features

🚀 Use Cases

get_incorporation_guide

request_email_otp

verify_email_otp

create_incorporation_draft

update_incorporation_draft

submit_incorporation

get_incorporation_status

Install

Remote endpoint