Skip to content

Production-ready CLI for Mon-voyage-pas-cher.com API - airports, cities, geography from your terminal

License

Notifications You must be signed in to change notification settings

ktmcp-cli/monvoyagepascher

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Banner

"Six months ago, everyone was talking about MCPs. And I was like, screw MCPs. Every MCP would be better as a CLI."

Peter Steinberger, Founder of OpenClaw Watch on YouTube (~2:39:00) | Lex Fridman Podcast #491

Mon Voyage Pas Cher CLI

⚠️ Unofficial CLI - Not officially sponsored or affiliated with Mon-voyage-pas-cher.com.

A production-ready command-line interface for Mon-voyage-pas-cher.com Public API — search airports, cities, countries, calculate distances, get sun positions, and more. Access comprehensive travel geography data directly from your terminal.

Features

  • Airport Search — Find airports by country, coordinates, or IATA code
  • City Discovery — Search cities by name, location, or population
  • Country Data — Get detailed country information and statistics
  • Distance Calculator — Calculate distances between coordinates or airports
  • Elevation Data — Get elevation for up to 20 locations at once
  • Sun Positions — Solar cycle data (sunrise, sunset, golden hour)
  • Timezone Info — Get timezone and current time for any location
  • Multi-language — Support for English, French, German, Spanish
  • JSON output — All commands support --json for scripting
  • Colorized output — Clean terminal output with chalk

Installation

npm install -g @ktmcp-cli/monvoyagepascher

Quick Start

# Set your API key
monvoyagepascher config set --api-key YOUR_API_KEY

# Search airports in France
monvoyagepascher airports --country FR

# Search cities
monvoyagepascher cities search "paris"

# Calculate distance between airports
monvoyagepascher distance CDG JFK --unit miles

# Get sun positions for a location
monvoyagepascher sun "48.8566,2.3522"

Commands

Config

monvoyagepascher config set --api-key <key>
monvoyagepascher config set --language fr
monvoyagepascher config show

Airports

monvoyagepascher airports --country US
monvoyagepascher airports --location "40.7128,-74.0060" --radius 100
monvoyagepascher airports --top --json

Cities

# Search by name
monvoyagepascher cities search "new york"
monvoyagepascher cities search "paris" --country FR

# Find nearby cities
monvoyagepascher cities nearby --location "48.8566,2.3522" --radius 50
monvoyagepascher cities nearby --country FR --limit 20

# Get significant cities
monvoyagepascher cities significant --country US
monvoyagepascher cities significant --population 80

Countries

monvoyagepascher countries              # List all countries
monvoyagepascher countries US           # Get specific country
monvoyagepascher countries --json       # All data as JSON

Continents

monvoyagepascher continents             # List all continents
monvoyagepascher continents EU          # Get specific continent

Distance

monvoyagepascher distance "40.7128,-74.0060" "48.8566,2.3522"
monvoyagepascher distance JFK CDG --unit miles
monvoyagepascher distance "0,0" "10,10" --json

Elevation

# Single location
monvoyagepascher elevation "48.8566,2.3522"

# Multiple locations (pipe-separated)
monvoyagepascher elevation "48.8566,2.3522|40.7128,-74.0060|51.5074,-0.1278"
monvoyagepascher elevation "0,0" --unit feet

Sun Positions

monvoyagepascher sun "48.8566,2.3522"
monvoyagepascher sun CDG --date 2024-06-21
monvoyagepascher sun "40.7128,-74.0060" --json

Timezone

monvoyagepascher timezone "48.8566,2.3522"
monvoyagepascher timezone JFK
monvoyagepascher timezone "0,0" --json

Ping

monvoyagepascher ping                   # Health check

JSON Output

All commands support --json for structured output:

monvoyagepascher airports --country US --json | jq '.data[] | select(.iata_code == "JFK")'
monvoyagepascher cities search "paris" --json | jq '.data[0]'
monvoyagepascher distance JFK CDG --json | jq '.data.distance'

Language Support

Set your preferred language globally:

monvoyagepascher config set --language fr

Or override per-command:

monvoyagepascher cities search "paris" --language de

Supported languages: en (English), fr (French), de (German), es (Spanish)

Why CLI > MCP?

No server to run. No protocol overhead. Just install and go.

  • Simpler — Just a binary you call directly
  • Composable — Pipe to jq, grep, awk
  • Scriptable — Works in cron jobs, CI/CD, shell scripts

License

MIT — Part of the Kill The MCP project.

About

Production-ready CLI for Mon-voyage-pas-cher.com API - airports, cities, geography from your terminal

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published