Instafan

io.github.gustavoatarPublished by GitHub account gustavoatarv1.1.0Updated Oct 24, 2026

Plan trips with friends: mood search, live briefs, top spots with photos, day-by-day itineraries.

VerifiedStreamable HTTPWeb executableLocation & LifestyleWeb Search & Scraping

Overview

AI-generated overview

Instafan is a hosted travel-planning MCP server that lets an assistant suggest destinations, brief on a place, list real rated spots with photos, and build day-

What you can do
Suggest 3-5 destinations from a trip mood or constraints, with reasons for each pick, and give a short brief on one destination covering its character, typical weather this month and official safety verdict, plus a postcard photo link. List the strongest real Google-rated places in a destination, either top attractions or a specific ask such as specialty coffee or rooftop bars. Show up to two real photos of a named spot inline, credited to their Google Maps authors, or a postcard of the destination. Build a day-by-day itinerary from a destination's strongest places, with links to run it as a group trip on Instafan.
When to use it
Useful when a traveller has not settled on a place and wants suggestions from a mood or constraints, or when they want a quick read on a destination's weather and safety before committing. Also fits requests for real, rated places and a day-by-day plan that can later become a shared group trip.
Requirements
A remote streamable-HTTP endpoint; no install and no authentication. The assistant or client must support remote MCP servers, configured with the Instafan endpoint URL. Network access to the service is required.
Before you install
Answers link back to instafan.app, where trips are continued as group decisions, so the service is promotional as well as informational. Destination, weather and safety data come from third-party sources (Google Places, climate normals, official advisories) and should be checked before booking. Photo credits belong to their Google Maps authors.

Installation

In SourceWeft

  1. Open Instafan in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.gustavoatar%2Finstafan/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "instafan": {
      "type": "http",
      "url": "https://instafan.app/mcp"
    }
  }
}

README

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

ToolWhat it doesInputs
find_destinationsA trip mood or constraint set ("somewhere warm in November, food-first") → 3–5 destination suggestions with the why.mood (required)
destination_briefOne destination: the story, typical weather this month, official safety verdict, a postcard photo link.destination (required)
top_spotsThe 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_itineraryA day-by-day plan built from the destination's strongest places.destination, days (both required)
spot_photosUp 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:

bash
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:

bash
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

License

MIT

Source: README.md at commit 14ab1cd

Tools

5

find_destinations

Suggest 3-5 destinations for a trip mood or constraint set, e.g. "somewhere warm in November, food-first". Use when the traveller has not settled on a place yet.

Parametersmoodrequired

destination_brief

A short brief on one destination: what it is like, typical weather now, official safety verdict. Use before or instead of a full itinerary.

Parametersdestinationrequired

top_spots

The strongest real places in a destination — top attractions by default, or a specific ask like "specialty coffee" or "rooftop bars". Real Google-rated places, never invented.

Parametersquerydestinationrequired

build_itinerary

Build a day-by-day itinerary for a destination from its strongest real places. Returns the plan plus links to run it as a group trip on Instafan.

Parametersdaysrequireddestinationrequired

spot_photos

Real photos of one spot — up to two shown inline plus direct photo links. Name a specific place ("Belém Tower") or leave spot empty for a postcard of the destination itself.

Parametersspotdestinationrequired

Version history

1
  1. v1.1.0LatestSep 16, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.