Travel Agent MCP Server 🌍✈️

An MCP (Model Context Protocol) server for retrieving visa and immigration information for various countries.

ℹ️ About

This server provides tools to access up-to-date visa and immigration details, helping users plan their international travel with ease. It leverages external APIs to fetch accurate information.

✨ Features

This server exposes the following tools:

GET_VISA_INFO_BY_COUNTRY

Retrieves detailed visa information for a specified country.

Parameters:
- countryCode (string, required): The ISO 3166-1 alpha-2 country code (e.g., 'US', 'GB', 'FR').
Returns: Visa type, requirements, validity, and any relevant notes for the specified country.

Usage Example:

{
  "tool_name": "GET_VISA_INFO_BY_COUNTRY",
  "arguments": {
    "countryCode": "CA"
  }
}

GET_IMMIGRATION_INFO_BY_COUNTRY

Retrieves detailed immigration information for a specified country.

Parameters:
- countryCode (string, required): The ISO 3166-1 alpha-2 country code (e.g., 'US', 'GB', 'FR').
Returns: Immigration type, requirements, validity, and any relevant notes for the specified country.

Usage Example:

{
  "tool_name": "GET_IMMIGRATION_INFO_BY_COUNTRY",
  "arguments": {
    "countryCode": "DE"
  }
}

🛠️ Setup

Clone the repository (if not already done).
Install dependencies:
```
pnpm install
```
or
```
npm install
```
Configure Environment Variables: Create a .env file in the root directory or set these variables in your environment:

Note: API keys and base URLs are not required for this service at the moment.
Build the project:
```
pnpm run build
```
or
```
npm run build
```
Start the MCP server:
```
pnpm start
```
or
```
npm start
```

🚀 Usage

The server communicates over stdio and can be used with any MCP-compatible client. Once the server is running, you can invoke the tools by sending JSON messages to its standard input.

⚠️ Error Handling

Common errors may include:

Missing API Keys/Base URLs: Ensure all required environment variables (VISA_API_KEY, VISA_API_BASE_URL, IMMIGRATION_API_KEY, IMMIGRATION_API_BASE_URL) are correctly set.
Invalid Country Code: Verify that the provided countryCode is a valid ISO 3166-1 alpha-2 code.
API Errors: Issues with the external APIs may result in errors. Check the server logs for more details.

🔑 Environment Variables

This Travel Agent MCP server provides essential tools for accessing visa and immigration information, powered by robust external services.

✨ Features

This server exposes the following tools:

GET_VISA_INFO_BY_COUNTRY

Retrieves detailed visa information for a specified country.

Parameters:

countryCode (string, required): The ISO 3166-1 alpha-2 country code (e.g., 'US', 'GB', 'FR').

Returns: Visa type, requirements, validity, and any relevant notes for the specified country.

Usage Example:

{
  "tool_name": "GET_VISA_INFO_BY_COUNTRY",
  "arguments": {
    "countryCode": "CA"
  }
}

GET_IMMIGRATION_INFO_BY_COUNTRY

Retrieves detailed immigration information for a specified country.

Parameters:

countryCode (string, required): The ISO 3166-1 alpha-2 country code (e.g., 'US', 'GB', 'FR').

Returns: Immigration type, requirements, validity, and any relevant notes for the specified country.

Usage Example:

{
  "tool_name": "GET_IMMIGRATION_INFO_BY_COUNTRY",
  "arguments": {
    "countryCode": "DE"
  }
}

🛠️ Setup

Clone the repository (if not already done).

Install dependencies:

pnpm install

npm install

Configure Environment Variables: Create a .env file in the root directory or set these variables in your environment:

Note: API keys and base URLs are not required for this service at the moment.

Build the project:

pnpm run build

npm run build

Start the MCP server:

pnpm start

npm start

⚠️ Error Handling

Common errors may include:

Missing API Keys/Base URLs: Ensure all required environment variables (VISA_API_KEY, VISA_API_BASE_URL, IMMIGRATION_API_KEY, IMMIGRATION_API_BASE_URL) are correctly set.

Invalid Country Code: Verify that the provided countryCode is a valid ISO 3166-1 alpha-2 code.

API Errors: Issues with the external APIs may result in errors. Check the server logs for more details.