# instafan [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/gustavoatar/instafan-mcp  
**GitHub Stars:** 0  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/instafan

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

## Claude Desktop Quick Installation
Remote MCP endpoint (confidence: high). Install path detected from listing signals. Add as a URL/SSE server in your client:

```json
"mcpServers": {
  "instafan": {
    "url": "https://instafan.app/mcp"
  }
}
```

## Documentation & 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

| 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:**
```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

- Discovery: [`/.well-known/mcp/server-card.json`](https://instafan.app/.well-known/mcp/server-card.json)
- Connect page: https://instafan.app/connect/

## License

MIT