Connect your AI agent

let an AI plan real trips in your account

Model Context Protocol

Your agent plans the trip. NeatTrip makes it real.

NeatTrip ships an open-source MCP server. Point Claude, Cursor, Claude Code - any MCP-capable agent - at it, and it builds a real trip in your account: stops on a map, a day-by-day plan, journal notes, photos, a packing list. The reasoning runs on your agent; you walk away with a durable, editable, shareable link - not a throwaway chat message.

try: “Plan me 5 days in Lisbon, food + architecture, then publish it.”

How it works
  1. Get a token. Sign in and open Connect your agent to generate a personal token (30 days, treat it like a password).
  2. Add the server to your MCP client and restart it - the config is below.
  3. Just talk to your agent. It builds the trip and hands you a /t/<slug> link.
Add to your MCP client

Claude Desktop (claude_desktop_config.json) or Cursor (~/.cursor/mcp.json):

{
  "mcpServers": {
    "neattrip": {
      "command": "npx",
      "args": ["-y", "@neattrip/mcp"],
      "env": { "NEATTRIP_TOKEN": "<your token>" }
    }
  }
}

On the CLI (Claude Code), one command:

claude mcp add neattrip -e NEATTRIP_TOKEN=<your token> -- npx -y @neattrip/mcp
What your agent can do
search_places

Geocode a place name → coordinates + a suggested category.

create_trip

Start a new trip (private by default); sets the map's route profile from the template.

add_stop

Add an ordered route stop, with nights, category, transport mode, and a photo.

reorder_stops

Set the whole route order in one call; renumbers stops and re-dates the plan.

update_stop

Edit a stop in place - rename, move, recategorise, change nights / transport, photo, or label.

delete_stop

Remove a route stop; the map route redraws without it.

add_place

Add a map pin that isn't a route stop (restaurants, beaches, viewpoints); optionally file it under a day.

add_plan_item

Add a scheduled itinerary item - eat / stay / do / transport - to a day.

add_journal_note

Add a journal field note that shows on the public trip page.

add_photo

Add a trip photo by URL (up to 100 per trip).

upload_photo

Upload a local image file and get back a hosted URL.

set_place_photo

Set or replace a stop's photo so it renders on the map and plan.

set_trip_cover

Set the hero / cover image shown on the public page and Discover card.

set_route_profile

Choose how the route is drawn - driving / cycling / walking.

add_packing_item

Add a packing-list entry - shared, personal, or assigned.

invite_crew

Invite someone by email; returns a join link.

publish_trip

Make the trip public and return its shareable /t/<slug> URL.

list_my_trips

List your trips with their ids and public links.

get_trip

Read a trip back so the agent can verify its own work.

Open source on npm as @neattrip/mcp. Trips are private until you (or your agent) call publish_trip.

Sign in & connect