
gaja-mcp
io.github.rlrdus-qq/gaja-mcp
Real-world measured visit big data and travel course recommendation MCP for South Korea.
Documentation
GAJA (κ°μ) - Korea Travel & Measured Visits MCP Server
GAJA is a production remote Model Context Protocol (MCP) server providing verified travel destinations and optimized itineraries across 250+ administrative districts in South Korea, powered by real-world telecommunication and navigation visit big data.
π Key Features
- Real-World Measured Big Data: Uses actual mobile carrier roaming and navigation movement volumes from the Korea Tourism Organization (TourAPI) and TMAP Big Data, eliminating hallucinations.
- Full Regional Coverage: 250+ cities, counties, and districts across South Korea (Seoul, Gangwon, Jeju, Busan, Inje, etc.).
- Multi-day Course Generator: Automatically generates 1-day to 8-day structured itineraries with morning/lunch/afternoon/dinner/lodging schedules and live weather forecasts.
- Foreign Visitor Surge Detection: Identifies rapidly emerging travel spots popular among inbound foreign tourists by nationality.
- Production-Ready & High Performance: Deployed over HTTP with Streamable-HTTP (
stateless_http=True), payload optimized under 16KB for compatibility with all MCP clients.
π‘ Live Remote MCP Endpoints
| Resource | URL | Description |
|---|---|---|
| MCP Live Endpoint | https://gaja.mocean.kr/mcp | Streamable-HTTP / JSON-RPC Transport |
| RFC Standard Discovery | https://gaja.mocean.kr/.well-known/mcp.json | Discovery manifest |
| Server Metadata | https://gaja.mocean.kr/.well-known/mcp-server.json | Schema & version descriptor |
| AI Context Index | https://gaja.mocean.kr/llms.txt | Context for LLMs & AI search engines |
π οΈ Provided Tools
1. gaja_recommend_trending_places
- Description: Recommends top trending travel destinations in South Korea based on statistically verified mobile visit counts.
- Parameters:
limit(integer, optional): Maximum number of destinations to return (default: 5, max: 20).category(string, optional): Travel category filter (nature,culture,leisure,food).
2. gaja_recommend_places
- Description: Generates an optimized, day-by-day travel itinerary with verified attractions, restaurants, and lodgings for any Korean district.
- Parameters:
query(string, required): Destination name (e.g.μΈμ κ΅°,κ°λ¦μ,μ μ£Όλ,Inje,Gangneung).days(integer, optional): Duration in days (1 to 8, default: 2).companion(string, optional): Travel companion type (solo,couple,family,friends).
3. gaja_get_foreign_surge
- Description: Analyzes regional districts experiencing a rapid surge in inbound foreign visitors compared to the previous period.
- Parameters:
top_n(integer, optional): Number of surging districts to return (default: 5).nationality(string, optional): Filter by visitor nationality (e.g.,ALL,JP,CN,US).
4. gaja_get_data_freshness
- Description: Returns the statistical baseline date, aggregation window, data provider provenance, and sample size of the underlying datasets.
π Client Configuration
Claude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"gaja": {
"url": "https://gaja.mocean.kr/mcp"
}
}
}
Note: For Claude Desktop versions supporting remote HTTP MCP, simply add the URL above.
Cursor / Windsurf
Add a new MCP server in settings:
- Type:
command(with mcp-proxy) or directstreamable-http/sse - URL:
https://gaja.mocean.kr/mcp
Kakao PlayMCP
GAJA is registered on Kakao PlayMCP (gaja identifier) with zero-authentication remote access:
- Endpoint:
https://gaja.mocean.kr/mcp
π Data Reliability & Provenance
Every recommendation returned by GAJA includes a PROVENANCE verification tag linking back to official government and telecom datasets:
- Korea Tourism Organization TourAPI 4.0
- TMAP Big Data Navigation Destination Index
- Korea Meteorological Administration Realtime Forecast
π License
This MCP server metadata and client integration specifications are licensed under the MIT License. Data sources comply with public data licenses (KOGL Type 1).
No installation packages available.