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/mcp

Tools

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/mcp

Cursor / 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