Dreamfare MCP

Travel tools for AI agents

Dreamfare is an AI-native travel platform that turns travel inspiration into bookable trips. The Dreamfare MCP server exposes the same capabilities to AI agents: an AI travel agent built on Claude, ChatGPT, Cursor or your own code can create and edit real trips, plan itineraries, search stays and activities with live prices, discover places, import travel videos and hand the finished trip to the traveler and their crew.

Endpoint https://api.dreamfare.app/mcp · Registry app.dreamfare/mcp · 21 tools

What the server can do

Every card below is a group of shipped tools, read from the server's own tool list. Trips made through the server are ordinary Dreamfare trips: on the map, editable in the app, shareable with a crew.

Trip creation and editing

Create a trip from a day-by-day plan or copy a published one, read it back with stop ids (plus crew, receipts, chat and travel essentials on request), edit anything in one batched call, put stops, saved places, search results, fares and receipts on it, and delete it.

AI itinerary planning

Build a complete trip in one call with Dreamfare's own planner: real venues with opening hours, a stay, partner activities, and booking links.

Place discovery and research

Find real venues for a destination with ratings, pins and photos, then research one option in depth or compare up to five side by side.

Flights, trains and rental cars

Compare available fares from city names or airport codes, refine a saved search without a new scrape, and read train and rental-car quotes. Prices remain indicative until partner checkout.

Hotel and stay search

Live stay inventory with all-in prices for a destination and date window; re-quote the stays already on a trip through edit_trip.

Activity and tour search

Bookable tours and experiences for a destination, attachable to a trip as a stop.

Travel link, text and file import

Turn a TikTok, Instagram, YouTube, Facebook or Reddit link, a web page, pasted notes, a screenshot or a PDF into real places with tips; read the results back through the library.

Saved places and travel tips

The traveler's library: browse and search saved places and tips (including what an import found), save a place for later, tidy folders, and keep the tips notebook.

Collaboration and trip chat

Invite people to a trip, manage roles, and post in the crew chat; votes and the chat itself are read through the trip.

Public trips

Browse what other travelers published on Explore and copy any of them; publishing a trip is an edit_trip action.

Traveler profile

Read the connected account (profile, membership, credits, wallet) and update profile fields.

Deliberately not exposed

  • Payments, subscriptions and credit purchases
  • Media uploads, account deletion and sign-in
  • Follows, notifications and reviews

Connect an agent

One remote server, Streamable HTTP, stateless: every POST is a complete JSON-RPC exchange, so any client or replica can call it. Travelers connecting from ChatGPT or Claude should start at Use Dreamfare in ChatGPT and Claude.

Claude

  1. Open Claude settings, then Connectors, then Add custom connector.
  2. Name it Dreamfare and paste https://api.dreamfare.app/mcp as the URL.
  3. Press Connect and sign in to a Dreamfare account. Every Claude plan can add it; free accounts get one custom connector.

ChatGPT

  1. Open ChatGPT settings, then Plugins.
  2. Search for Dreamfare Travel Assistant and choose Connect.
  3. Sign in to a Dreamfare account when asked, then ask to plan a trip.

Claude Code, Cursor, VS Code

Add a remote server. The first tool call opens the sign-in flow in a browser.

# Claude Code
claude mcp add --transport http dreamfare https://api.dreamfare.app/mcp

# Cursor (.cursor/mcp.json)
{ "mcpServers": { "dreamfare": { "url": "https://api.dreamfare.app/mcp" } } }

# VS Code (.vscode/mcp.json)
{ "servers": { "dreamfare": { "type": "http", "url": "https://api.dreamfare.app/mcp" } } }

Any MCP client

initialize, ping and tools/list answer anonymously, so a registry or a script can read the catalog before anyone signs in. Everything else needs the bearer token from the OAuth flow.

curl -X POST https://api.dreamfare.app/mcp \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Authentication and limits

  • OAuth 2.1 with PKCE and dynamic client registration (RFC 7591). Register as a public client; token exchange needs no client secret.
  • Discovery at https://api.dreamfare.app/.well-known/oauth-authorization-server and https://api.dreamfare.app/.well-known/oauth-protected-resource. An unauthenticated tool call returns 401 with a WWW-Authenticate header that names the resource metadata, which is how clients find the flow.
  • Scope: the token acts only on the traveler who signed in, with the same permissions they have in the app. Shared trips respect crew roles.
  • Rate limit: 120 requests per minute per client. Responses are JSON; no SSE stream and no session id to keep.
  • Money at this boundary is in major units of the stated ISO currency (a night at 120 USD is 120); the app stores minor units.

Prompts that work

The same requests a traveler types in chat, each answered with an interactive trip card in Claude and ChatGPT.

  • Plan 5 days in Tokyo for late April with a mix of food and temples, then save it to Dreamfare.
  • Import this TikTok and tell me which places are worth a day trip: <paste link>
  • Find a hotel in Kyoto for May 10 to 12 under $200 a night and add the best one to my trip.
  • What is still unbooked on my Lisbon trip? Give me the booking links.
  • Make an invite link so a friend can edit my Lisbon trip, then post in the trip chat that dinner is booked.
  • Show me trips other travelers published for Portugal, and copy the Algarve one into my plans.

Tool flows for agents

Typical call sequences. Read a trip after any write: stops are enriched with pins, photos and booking links a few seconds later.

  1. Compare flights and save a fare

    search_flights→add_to_trip→display_card

  2. From a prompt to a bookable trip

    create_trip→search_stays→display_card→add_to_trip→edit_trip

  3. From a travel video to itinerary stops

    import_places→list_library→add_to_trip→display_card

  4. Start from someone else's itinerary

    explore_trips→create_trip→edit_trip→display_card→manage_crew

Questions

What is a travel MCP server?
The Model Context Protocol is the open standard AI assistants and agents use to call external tools. A travel MCP server exposes travel capabilities as those tools. Dreamfare's server lets an agent create and edit real trips, plan itineraries, search stays and activities with live prices, discover places, import travel videos and share trips, all on the connected traveler's Dreamfare account.
Which AI clients work with it?
Claude (claude.ai, desktop and mobile, as a custom connector on every plan), ChatGPT (the Dreamfare Travel Assistant plugin), Claude Code, Cursor, VS Code and any MCP client that speaks Streamable HTTP. Claude and ChatGPT render Dreamfare's interactive trip cards; other clients get the same tools as text.
How does authentication work?
OAuth 2.1 with PKCE and dynamic client registration. The traveler signs in on dreamfare.app, the agent receives a bearer token scoped to that account, and the agent never sees a password. Access can be revoked from the client's settings at any time.
Does it search flights?
Dreamfare searches flights from the fare sources configured for the route. Results can be compared by price, duration and stops, then attached to an itinerary. Only sources that return a quote are represented. Prices are indicative until confirmed on the booking partner's site.
Does using the server cost anything?
Connecting is free. AI planning and imports use your account's current plan or Stardust allowance. The app shows access, available credits and action costs. Premium offers a free trial where available; check the current offering and renewal terms before subscribing.
Can an agent book a trip?
Dreamfare organizes the plan and links to booking partners. You complete payment on the partner's site. Adding a flight, stay or activity to an itinerary does not reserve it or purchase it; mark it booked after checkout and keep the confirmation with the trip.

Keep reading

Plans, credit costs and partner booking explained