Visa Checker MCP Server

A specialized MCP (Model Context Protocol) server for checking visa appointment availability in real-time

⚡ Quick Start

# Navigate to your project
cd visa-checker-mcp

# Install dependencies (20-30x faster than npm!)
bun install

# Run stdio transport server
bun run dev:stdio

# Run HTTP server with SSE support
bun run dev:http

🚀 Features

🔧 Modern Tooling

• Bun - Lightning-fast package manager and runtime
• TypeScript - Full type safety with comprehensive validation
• ESLint + Prettier - Code linting and formatting
• Vitest - Fast unit testing framework

📡 Visa Appointment Checking

• Live Data: Real-time visa appointment availability from visasbot.com API
• Smart Caching: 5-minute intelligent caching to reduce API load
• Error Resilience: Automatic fallback to cached data when API is unavailable
• Comprehensive Filtering: Filter by country, mission, status, and visa type
• Rich Formatting: Emoji-enhanced status indicators and detailed information

🛠️ MCP Capabilities

• Tools:
  • fetch-visa-appointments - Get comprehensive appointment data with filtering
  • get-open-appointments - Get only centers with available appointments
  • search-visa-centers - Advanced search with multiple filter options
• Resources:
  • visa://appointments - Complete live visa appointment data (JSON)
  • visa://appointments/{country_code}/{mission_code} - Filtered data by country codes
• Features:
  • Transport-aware Logging: Proper stderr logging for stdio compatibility
  • Zod Validation: Runtime type checking for all parameters
  • Error Handling: Graceful degradation with cached data fallback
  • Standards Compliant: Follows official MCP specification

📁 Project Structure

visa-checker-mcp/
├── src/
│   ├── index.ts            # Main MCP server with visa tools and resources
│   ├── services/
│   │   ├── visa.ts         # Visa API client and data processing
│   │   └── visa.test.ts    # Unit tests for visa service
│   ├── config/
│   │   └── server.ts       # Server configuration
│   └── utils/
│       └── logger.ts       # Transport-aware logging
├── package.json            # Project configuration
├── tsconfig.json          # TypeScript configuration
└── README.md              # This file

🎯 Usage Examples

Visa Appointment Checking

The server provides powerful visa appointment checking capabilities through the visasbot.com API:

Available Tools:

1. fetch-visa-appointments - Get comprehensive visa appointment data

   // Get all appointments
   await tool.call('fetch-visa-appointments', {})
   
   // Filter by country (Turkey to Netherlands)
   await tool.call('fetch-visa-appointments', {
     country_code: 'tur',
     mission_code: 'nld'
   })
   
   // Filter by status
   await tool.call('fetch-visa-appointments', {
     status: 'open'
   })