io.github.gustavoatar/instafan
Plan trips with friends: mood search, live briefs, top spots with photos, day-by-day itineraries.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
claude mcp add --transport http instafan 'https://instafan.app/mcp'{
"mcpServers": {
"instafan": {
"type": "http",
"url": "https://instafan.app/mcp"
}
}
}Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Instafan MCP Server
Let AI agents plan real trips — where to go for a mood, what a destination is like right now, its strongest Google-rated places with photos, and a day-by-day plan — using Instafan's live data (Google Places, climate normals, official safety advisories).
Hosted, no install, no auth. Streamable-HTTP endpoint:
https://instafan.app/mcpTools
| Tool | What it does | Inputs |
|---|---|---|
find_destinations | A trip mood or constraint set ("somewhere warm in November, food-first") → 3–5 destination suggestions with the why. | mood (required) |
destination_brief | One destination: the story, typical weather this month, official safety verdict, a postcard photo link. | destination (required) |
top_spots | The strongest real Google-rated places — top attractions by default, or a specific ask like "rooftop bars" — with photo links. Never invented. | destination (required), query |
build_itinerary | A day-by-day plan built from the destination's strongest places. | destination, days (both required) |
spot_photos | Up to two real photos of one spot, embedded inline as MCP image blocks plus direct links, credited to their Google Maps authors. | destination (required), spot |
Connect
ChatGPT → Settings → Apps & Connectors → enable Developer mode → Create → URL: https://instafan.app/mcp, auth: none.
Claude Desktop / Claude.ai → Settings → Connectors → Add custom connector → URL: https://instafan.app/mcp
Claude Code:
claude mcp add instafan --transport http https://instafan.app/mcpCursor / other MCP clients — add a remote (streamable-http) server pointing at the URL above. One-click: see https://instafan.app/connect/
Test with curl:
curl -s -X POST https://instafan.app/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'Example
"Build me a Lisbon trip for my wife and I in the best weather."
The agent calls destination_brief → learns Lisbon is 18–26°C with ~4 rainy days right now and officially rated relaxed; top_spots → real rated places with photos; spot_photos → Belém Tower, inline; build_itinerary → a day-by-day plan. Every answer links back into instafan.app, where the trip becomes a group decision — immerse in 3D, save spots, let the group vote.
About
Built by Instafan — plan trips with friends. https://instafan.app
- Discovery:
/.well-known/mcp/server-card.json - Connect page: https://instafan.app/connect/
License
MIT
Frequently asked questions
What is io.github.gustavoatar/instafan?
Plan trips with friends: mood search, live briefs, top spots with photos, day-by-day itineraries.
How do I install io.github.gustavoatar/instafan?
It runs as a remote server. In Claude Code: claude mcp add --transport http instafan 'https://instafan.app/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.
Does io.github.gustavoatar/instafan need an API key?
Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.
Is io.github.gustavoatar/instafan open source?
Its code is public on GitHub, but the repository does not declare a standard license.
Who maintains io.github.gustavoatar/instafan?
It is published by gustavoatar. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.