Check visa requirements, then prepare and file visa applications with Visarun.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Puts an existing application into a trip. Same effect when repeated.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http mcp https://api.visarun.ai/api/mcp
Puts an existing application into a trip. Same effect when repeated.
| Argument | Type | Description |
|---|---|---|
| trip_id* | string | |
| application_id* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"trip_id",
"application_id"
],
"properties": {
"trip_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"
},
"application_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"
}
}
}Sends the person's question to a Visarun visa specialist, who answers in the application: visarun_get_application lists the questions and answers. Only a submitted application has a specialist queue, and one question waits at a time: otherwise nothing is sent (sent: false, with the reason). whatsapp_url, when the organization has one, is its business WhatsApp: give it to the person for a faster answer.
| Argument | Type | Description |
|---|---|---|
| context | string | What the specialist should know to answer |
| message* | string | The person's question |
| application_id* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"application_id",
"message"
],
"properties": {
"context": {
"type": "string",
"maxLength": 2000,
"description": "What the specialist should know to answer"
},
"message": {
"type": "string",
"maxLength": 2000,
"minLength": 1,
"description": "The person's question"
},
"application_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"
}
}
}Use this when someone asks whether they need a visa for a country, what a visa with Visarun costs, which documents it takes or how long it takes: 'do I need a visa for Dubai on an Indian passport', 'هل أحتاج تأشيرة لدبي بجواز سفر هندي؟', 'нужна ли виза в Таиланд с российским паспортом', 'क्या भारतीय पासपोर्ट पर थाईलैंड के लिए वीज़ा चाहिए?', 'how much is a Schengen visa from Dubai'. To compare destinations, call it for each. Not for where a passport can go: that is visarun_list_destinations. It answers whether Visarun can file a visa for this traveller and destination (supported), which questionnaire it uses, the main documents it asks for (required_documents, a short list: visarun_get_application_fields lists every upload once the application exists, and visarun_get_requirements what a consulate or visa centre checks) and the estimated processing days. For a traveller who pays Visarun, without signing in or signed in as Visarun's own customer, it also carries price_from, the least an adult pays before answers that may raise it (government_fee, service_fee and premium_fee add up to amount; card_processing is what checkout adds), and apply_url, where the person applies on the Visarun site. For a traveller who pays Visarun, reason not_offered means Visarun files it for agencies only, or the signed-in member's own countries leave it out; message says which. Ask before creating an application. eligibility_questions are the questions New Application asks this passport for this destination (which visas or permits the traveller holds, what they travel on): ask the person, then check again with their answers in held_credentials, the values of the options they hold or the none option's. For our own customers an answer is needed before creating; some answers close the online route, and some waive the visa (visa_free, with what to do before flying in message). Tell the person each of warnings (a US travel restriction, Saudi Arabia's embassy review, a trip longer than the visa allows or sooner than its processing time) before creating.
| Argument | Type | Description |
|---|---|---|
| purpose | string | |
| residence | string | Country of residence, ISO-2 |
| visa_type | string | A code or label from visa_types, in any case; one not offered for this passport, or not filed for this trip, is refused |
| citizenship* | string | Passport nationality, ISO-2 |
| destination* | string | Destination country, ISO-2 (e.g. SA) |
| organization_id | string | |
| travel_end_date | string | YYYY-MM-DD |
| held_credentials | array | Answers to eligibility_questions: the values of the options the traveller holds, or the none option's value |
| travel_start_date | string | YYYY-MM-DD |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"destination",
"citizenship"
],
"properties": {
"purpose": {
"type": "string"
},
"residence": {
"type": "string",
"maxLength": 2,
"minLength": 2,
"description": "Country of residence, ISO-2"
},
"visa_type": {
"type": "string",
"description": "A code or label from visa_types, in any case; one not offered for this passport, or not filed for this trip, is refused"
},
"citizenship": {
"type": "string",
"maxLength": 2,
"minLength": 2,
"description": "Passport nationality, ISO-2"
},
"destination": {
"type": "string",
"description": "Destination country, ISO-2 (e.g. SA)"
},
"organization_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"
},
"travel_end_date": {
"type": "string",
"description": "YYYY-MM-DD"
},
"held_credentials": {
"type": "array",
"items": {
"type": "string",
"maxLength": 64,
"minLength": 1
},
"maxItems": 20,
"description": "Answers to eligibility_questions: the values of the options the traveller holds, or the none option's value"
},
"travel_start_date": {
"type": "string",
"description": "YYYY-MM-DD"
}
}
}Use this when someone wants to apply: 'apply for a UAE tourist visa for me', 'قدّم لي طلب تأشيرة سياحية للإمارات', 'оформи мне визу в ОАЭ', 'मेरे लिए यूएई टूरिस्ट वीज़ा का आवेदन करो'. A draft visa application for one traveller. Use the create_with values from check_eligibility, held_credentials included: the questionnaire takes the answers. Creates a record; call once per traveller.
| Argument | Type | Description |
|---|---|---|
| country* | string | |
| purpose | string | |
| trip_id | string | |
| visa_type* | string | |
| citizenship | string | |
| applicant_name | string | |
| organization_id | string | |
| travel_end_date | string | |
| held_credentials | array | Answers to eligibility_questions: the values of the options the traveller holds, or the none option's value |
| travel_start_date* | string | YYYY-MM-DD |
| country_of_residence | string | |
| applicant_relationship | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"country",
"visa_type",
"travel_start_date"
],
"properties": {
"country": {
"type": "string",
"maxLength": 2,
"minLength": 2
},
"purpose": {
"type": "string"
},
"trip_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"
},
"visa_type": {
"type": "string"
},
"citizenship": {
"type": "string",
"maxLength": 2,
"minLength": 2
},
"applicant_name": {
"type": "string"
},
"organization_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"
},
"travel_end_date": {
"type": "string"
},
"held_credentials": {
"type": "array",
"items": {
"type": "string",
"maxLength": 64,
"minLength": 1
},
"maxItems": 20,
"description": "Answers to eligibility_questions: the values of the options the traveller holds, or the none option's value"
},
"travel_start_date": {
"type": "string",
"description": "YYYY-MM-DD"
},
"country_of_residence": {
"type": "string",
"maxLength": 2,
"minLength": 2
},
"applicant_relationship": {
"type": "string"
}
}
}A group trip. travellers[] creates one draft application per traveller in the same call. Creates records; call once per trip.
| Argument | Type | Description |
|---|---|---|
| name* | string | |
| travellers | array | |
| organization_id | string | |
| travel_end_date | string | |
| travel_start_date | string | |
| destination_country* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name",
"destination_country"
],
"properties": {
"name": {
"type": "string",
"minLength": 1
},
"travellers": {
"type": "array",
"items": {
"type": "object",
"properties": {
"visa_type": {
"type": "string"
},
"applicant_name": {
"type": "string"
},
"applicant_relationship": {
"type": "string"
}
}
}
},
"organization_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"
},
"travel_end_date": {
"type": "string"
},
"travel_start_date": {
"type": "string"
},
"destination_country": {
"type": "string",
"maxLength": 2,
"minLength": 2
}
}
}Not for a file attached in this chat: that goes to visarun_upload_document's file. An address to put one file's bytes into Visarun storage with an HTTP PUT, for a file over 3 MB or one on disk: run curl -X PUT -H 'Content-Type: <its type>' --data-binary @<file> '<upload_url>' where you have a terminal, then call visarun_upload_document with the staged_path. It lasts two hours and takes one file. Without a terminal (a chat), you cannot send the file: create a one-time upload page with visarun_create_upload_page.
| Argument | Type | Description |
|---|---|---|
| size* | integer | The file's size in bytes |
| file_name* | string | |
| application_id* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"application_id",
"file_name",
"size"
],
"properties": {
"size": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The file's size in bytes",
"exclusiveMinimum": 0
},
"file_name": {
"type": "string"
},
"application_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"
}
}
}Not for a file attached in this chat: that goes to visarun_upload_document's file. A one-time page where the person uploads one document from their phone or computer without signing in: for a chat that cannot send the file. Give the person url and say it works once, for 30 minutes. When they say it is uploaded, call visarun_upload_document with upload_page_id: it is read and put in its field as any other upload. document_type and field_key from the fields call (documents.items[]). For a passport page field (a cover, a last page) with no page of its own (none found, or the one cut read nothing, failed or was never read) while the passport field holds a PDF, the page shows that PDF's pages as thumbnails and the person taps the one the field takes (picks_page: true): tell them so; after they say it is done, visarun_upload_document with upload_page_id puts that page in the field.
| Argument | Type | Description |
|---|---|---|
| field_key | string | |
| document_type* | string | |
| application_id* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"application_id",
"document_type"
],
"properties": {
"field_key": {
"type": "string"
},
"document_type": {
"type": "string"
},
"application_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"
}
}
}Moves the application to the deleted list. Owners and admins of the organization delete any; a manager their assigned clients'; a member or a manager an application they own until it is submitted or paid. Nobody deletes it while a payment for it is processing or a payment request for it is open. Its open payment pages close first. Its owner or staff can restore it. Confirm with the human first.
| Argument | Type | Description |
|---|---|---|
| application_id* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"application_id"
],
"properties": {
"application_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"
}
}
}A new draft with the same answers and documents, for the next traveller or the next trip. Creates a record; call once per copy.
| Argument | Type | Description |
|---|---|---|
| application_id* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"application_id"
],
"properties": {
"application_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"
}
}
}Use this when someone asks where one application stands: 'what is the status of my Dubai visa', 'ما حالة تأشيرتي لدبي؟', 'какой статус у моей визы в Таиланд', 'मेरे थाईलैंड वीज़ा की स्थिति क्या है?'. Status, completion, payment state and trip of one application, with the UI link to open it in the browser. When next_action is awaiting_payment, that page is where the account holder pays.
| Argument | Type | Description |
|---|---|---|
| application_id* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"application_id"
],
"properties": {
"application_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"
}
}
}The questionnaire of an application as data, in two parts. documents: each file to upload with its status (missing, reading, read, failed, uploaded) and, once read, what it read in answer keys (files[].read.answers, with confirmed_by_mrz naming the values the passport's check digits confirm); a passport page field's PDF (a cover, a last page) has page: prepared with the page cut out of it, not_found when the PDF has no such page, or not_prepared while it is not cut: for one not_found, still not_prepared minutes after its upload, or prepared but read with no answers, failed or never read (the cut likely took the wrong page, unless that passport's last page prints no address, as most outside India do), visarun_create_upload_page for that field shows the person the passport PDF's pages to tap the right one, or takes a photo of that page. answers: steps of fields with current values, which are required right now, option lists and info boxes as notes, and missing, the answers still needed. Read it before uploading and before saving answers, and again after a save: an answer can open new fields.
| Argument | Type | Description |
|---|---|---|
| application_id* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"application_id"
],
"properties": {
"application_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"
}
}
}Every version of the application's answers: who changed them (a person, Mira, OCR, an organization default) and when.
| Argument | Type | Description |
|---|---|---|
| application_id* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"application_id"
],
"properties": {
"application_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"
}
}
}The full value list of one select field (when the fields call truncated it). answers supplies the parent values a dependent list needs.
| Argument | Type | Description |
|---|---|---|
| answers | object | |
| field_key* | string | |
| questionnaire_type* | string | From the fields call, questionnaire.type |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"questionnaire_type",
"field_key"
],
"properties": {
"answers": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
},
"field_key": {
"type": "string"
},
"questionnaire_type": {
"type": "string",
"description": "From the fields call, questionnaire.type"
}
}
}The tourist or short-term business visa requirements for a destination, from the table Mira reads: documents, processing time, fees and the official page they come from (source). They are general, not checked against a nationality: whether the person needs a visa at all is visarun_check_eligibility's answer. What a given application asks is in visarun_get_application_fields.
| Argument | Type | Description |
|---|---|---|
| country* | string | The destination, a name or ISO code |
| visa_type | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"country"
],
"properties": {
"country": {
"type": "string",
"description": "The destination, a name or ISO code"
},
"visa_type": {
"enum": [
"tourist",
"business"
],
"type": "string"
}
}
}Use this when someone asks whether their visa is approved or wants its file: 'is my visa approved', 'هل تمت الموافقة على تأشيرتي؟', 'одобрили ли мою визу', 'क्या मेरा वीज़ा मंज़ूर हो गया?'. After submission: how it was filed (filing: government, an acknowledgement from the government; form_delivered, a form-only country's completed form handed to the applicant, which the government never acknowledges to us; unconfirmed), the decision, and a 15-minute link to the issued visa file when one exists.
| Argument | Type | Description |
|---|---|---|
| application_id* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"application_id"
],
"properties": {
"application_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"
}
}
}One trip with its travellers' applications.
| Argument | Type | Description |
|---|---|---|
| trip_id* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"trip_id"
],
"properties": {
"trip_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"
}
}
}Invites a person to the organization by email with a role. Only they receive the link to join, by email; email_sent says whether it went out (if not, an owner or admin resends it from the Team page in Visarun). Ask the human before inviting.
| Argument | Type | Description |
|---|---|---|
| role* | string | |
| email* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"email",
"role"
],
"properties": {
"role": {
"enum": [
"admin",
"manager",
"member",
"client"
],
"type": "string"
},
"email": {
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
}
}
}The people the application is shared with, and whether they may view or edit it.
| Argument | Type | Description |
|---|---|---|
| application_id* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"application_id"
],
"properties": {
"application_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"
}
}
}Use this when someone asks about their applications: 'show my visa applications', 'ما هي طلبات التأشيرة الخاصة بي؟', 'покажи мои заявки на визу', 'मेरे वीज़ा आवेदन दिखाओ'. Applications the account can see, newest first. Filters are optional.
| Argument | Type | Description |
|---|---|---|
| page | integer | |
| trip | string | Only applications of this trip |
| limit | integer | |
| status | string | Comma-separated statuses |
| country | string | Comma-separated ISO-2 codes |
| organization_id | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"trip": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$",
"description": "Only applications of this trip"
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"status": {
"type": "string",
"description": "Comma-separated statuses"
},
"country": {
"type": "string",
"description": "Comma-separated ISO-2 codes"
},
"organization_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"
}
}
}Use this when someone asks where they can travel, or which visa Visarun can get them: 'where can I go on an Indian passport', 'which e-visas can I get living in Dubai', 'أين يمكنني السفر بجواز سفر باكستاني؟', 'куда можно поехать с паспортом Казахстана', 'मैं भारतीय पासपोर्ट से कहाँ जा सकता हूँ?', 'which visa can I get fastest'. Not for one destination's documents or warnings: that is visarun_check_eligibility. It lists the destinations Visarun files for this citizenship and residence, each with its visa type, estimated_processing_days and price_from, an adult's least price before card processing, whose government_fee, service_fee and premium_fee add up to amount (null where nothing is paid in the app); ask_first lists those where the traveller answers a question first, which visarun_check_eligibility asks. Destinations that need no visa are not listed. For a traveller who pays Visarun, without signing in or signed in as Visarun's own customer, each carries apply_url, where the person applies on the Visarun site; signed in, the list is the organization's.
| Argument | Type | Description |
|---|---|---|
| residence | string | Country of residence, ISO-2 |
| citizenship* | string | Passport nationality, ISO-2 |
| organization_id | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"citizenship"
],
"properties": {
"residence": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"description": "Country of residence, ISO-2"
},
"citizenship": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"description": "Passport nationality, ISO-2"
},
"organization_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"
}
}
}Files linked to an application, as the questionnaire lists them. What their reading found is in visarun_validate_application.
| Argument | Type | Description |
|---|---|---|
| application_id* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"application_id"
],
"properties": {
"application_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"
}
}
}What happened since a cursor: applications created, status changes, documents linked, payments, submissions and the government's decisions, oldest first. Pass next_cursor back as since. With application_id, one application's events; without, the organization's (owners and admins).
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| since | string | next_cursor from the previous call |
| application_id | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"since": {
"type": "string",
"pattern": "^\\d+$",
"description": "next_cursor from the previous call"
},
"application_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"
}
}
}The organization's members and their roles.
No arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
}Shared files of a trip (hotel booking, sponsor statement) that apply to every traveller.
| Argument | Type | Description |
|---|---|---|
| trip_id* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"trip_id"
],
"properties": {
"trip_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"
}
}
}Group trips the account can see.
| Argument | Type | Description |
|---|---|---|
| page | integer | |
| limit | integer | |
| organization_id | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"organization_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"
}
}
}A deep check of the application by Mira, Visarun's application checker, the one Validate runs in the app, up to two minutes: contradictions between the answers, the documents, the trip and the chat that no rule catches, and corrections already checked against each field's rules. It changes no answer: save the proposals you accept with visarun_save_answers. visarun_validate_application is the fast check by rules alone.
| Argument | Type | Description |
|---|---|---|
| application_id* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"application_id"
],
"properties": {
"application_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"
}
}
}Merges answers into the application's questionnaire (keys from get_application_fields). A select takes an option's value or label, a checkbox true or false, a date YYYY-MM-DD; normalized lists what was converted. A key the form does not have, or a value it does not take, refuses the whole call with 422 (rejected names the allowed values) and saves nothing. Omitted keys keep their values; null clears one. Saving the same answers twice changes nothing. The answer lists what is still missing (answers.missing, documents.missing): an answer can open new fields. dry_run: true checks the same and saves nothing. Values a document's reading gave (get_application_fields, documents.items[].files[].read.answers) are saved only through this call: check them with the person first.
| Argument | Type | Description |
|---|---|---|
| answers* | object | |
| dry_run | boolean | true: check and answer what a save would do, save nothing |
| application_id* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"application_id",
"answers"
],
"properties": {
"answers": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"dry_run": {
"type": "boolean",
"description": "true: check and answer what a save would do, save nothing"
},
"application_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"
}
}
}Gives a person access to the application by email, to view or to edit; they see it in Visarun when they sign in. No email is sent. Ask the human before sharing.
| Argument | Type | Description |
|---|---|---|
| note | string | |
| email* | string | |
| access_level | string | |
| application_id* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"application_id",
"email"
],
"properties": {
"note": {
"type": "string"
},
"email": {
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
},
"access_level": {
"enum": [
"view",
"edit"
],
"type": "string"
},
"application_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"
}
}
}Files the application with the government portal. Irreversible: confirm with the human first. There is no dry run: visarun_validate_application checks readiness. Refused with 422 while answers are missing or invalid, 402 until the account holder pays on the application's page in the app (links.ui of visarun_get_application), and 409 ONLINE_ROUTE_NOT_ELIGIBLE where a card of the questionnaire closes the online route for the answers and it is not paid (retrying does not help: contact Visarun); an application already submitted answers 200 with already_submitted: true and files nothing again.
| Argument | Type | Description |
|---|---|---|
| application_id* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"application_id"
],
"properties": {
"application_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"
}
}
}Use this when someone sends a document for an application: 'here is my passport', 'هذا جواز سفري', 'вот мой паспорт', 'यह रहा मेरा पासपोर्ट'. Uploads one file to an application through the questionnaire's own pipeline: the file the person attached in this chat, in file (at most 10 MB); its bytes in file_base64 (at most 3 MB), the staged_path of a file put into storage through visarun_create_upload_link, or the upload_page_id of a page the person uploaded it on (visarun_create_upload_page). A file that lands in a field is then read in the background, usually for under a minute (OCR, forensics, the passport-photo face check); the upload changes no answer. Call visarun_get_application_fields once it is read: documents.items[].files[].read.answers holds what it read, in the keys visarun_save_answers takes; check them with the person and save the ones they accept. document_type and field_key from the fields call (documents.items[]). A passport, ID card or residence permit put over another is compared with it first, about a minute: another person's document or a worse scan leaves the previous one in the field (replacement_kept_previous, with what differs); replace: keep_new puts the new one in anyway. If the call ends before its answer, visarun_get_application_fields shows which file the field holds (documents.items[].files). A passport PDF put in the passport field also fills the empty page fields (a cover, a last page) with its pages: the answer's pages names each (filled; kept or taken when it holds another file, maybe an older passport's page; failed when it got none), and the fields call shows the page each one uses (files[].page).
| Argument | Type | Description |
|---|---|---|
| file | object | The file the person attached in this chat |
| replace | string | keep_new: skip the comparison with the document held |
| field_key | string | |
| file_name | string | The file's name; not needed with upload_page_id |
| mime_type | string | image/jpeg, image/png or application/pdf |
| file_base64 | string | The file bytes, base64; or staged_path |
| staged_path | string | From visarun_create_upload_link, once the file is PUT there |
| document_type* | string | |
| application_id* | string | |
| upload_page_id | string | From visarun_create_upload_page, once the person says the file is uploaded, with the document_type and field_key the page was made for |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"application_id",
"document_type"
],
"properties": {
"file": {
"type": "object",
"required": [
"download_url",
"file_id"
],
"properties": {
"file_id": {
"type": "string"
},
"file_name": {
"type": "string"
},
"mime_type": {
"type": "string"
},
"download_url": {
"type": "string"
}
},
"description": "The file the person attached in this chat"
},
"replace": {
"enum": [
"keep_new"
],
"type": "string",
"description": "keep_new: skip the comparison with the document held"
},
"field_key": {
"type": "string"
},
"file_name": {
"type": "string",
"description": "The file's name; not needed with upload_page_id"
},
"mime_type": {
"type": "string",
"description": "image/jpeg, image/png or application/pdf"
},
"file_base64": {
"type": "string",
"description": "The file bytes, base64; or staged_path"
},
"staged_path": {
"type": "string",
"description": "From visarun_create_upload_link, once the file is PUT there"
},
"document_type": {
"type": "string"
},
"application_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"
},
"upload_page_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$",
"description": "From visarun_create_upload_page, once the person says the file is uploaded, with the document_type and field_key the page was made for"
}
}
}One shared file for the whole trip (hotel booking, invitation, sponsor statement). The file the person attached in this chat goes in file (at most 10 MB).
| Argument | Type | Description |
|---|---|---|
| file | object | The file the person attached in this chat |
| name* | string | |
| trip_id* | string | |
| file_name* | string | |
| mime_type | string | |
| description | string | |
| file_base64 | string | |
| document_type* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"trip_id",
"name",
"document_type",
"file_name"
],
"properties": {
"file": {
"type": "object",
"required": [
"download_url",
"file_id"
],
"properties": {
"file_id": {
"type": "string"
},
"file_name": {
"type": "string"
},
"mime_type": {
"type": "string"
},
"download_url": {
"type": "string"
}
},
"description": "The file the person attached in this chat"
},
"name": {
"type": "string"
},
"trip_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"
},
"file_name": {
"type": "string"
},
"mime_type": {
"type": "string"
},
"description": {
"type": "string"
},
"file_base64": {
"type": "string"
},
"document_type": {
"type": "string"
}
}
}What submit will say right now: missing or invalid answers per step, document problems, warnings. ready_to_submit true means submit will go through (payment aside); a FILED_BY_SPECIALIST warning means it goes to a Visarun specialist who files it by hand, as the automation does not file these answers (the warning says why): tell the person. An issue's resolve_with lists the ticks the form offers to clear it (an acknowledgement such as 'I will arrange travel insurance separately', a Does Not Apply box) as answers for visarun_save_answers; empty when only an upload or a corrected answer clears it.
| Argument | Type | Description |
|---|---|---|
| application_id* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"application_id"
],
"properties": {
"application_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"
}
}
}The account behind the token, its organizations and the default organization_id for new trips and applications. Call first.
No arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 16, 2026.