> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stardrift.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Stardrift to Claude

> Let an AI assistant read and edit your Stardrift trips, itineraries, and saved places over MCP.

Stardrift's public MCP endpoint is `https://stardrift.ai/mcp`. Connect it to let an assistant read your travel plans, build and correct itineraries, record stays and events, and organize saved places on your behalf.

## Connect

<Tabs>
  <Tab title="Claude Code">
    ```bash theme={null}
    claude mcp add --transport http stardrift https://stardrift.ai/mcp
    claude mcp login stardrift
    ```

    Complete sign-in and consent in the browser. You can also manage the connection using Claude Code's `/mcp` menu.
  </Tab>

  <Tab title="claude.ai">
    Open **Settings → Connectors → Add custom connector**, enter `https://stardrift.ai/mcp`, then sign in and approve the requested permissions.
  </Tab>

  <Tab title="Any MCP client">
    Use `https://stardrift.ai/mcp` with Streamable HTTP. An unauthenticated request returns `401` with a `WWW-Authenticate` header pointing to OAuth resource metadata at `/.well-known/oauth-protected-resource`.
  </Tab>
</Tabs>

Use your Stardrift account and review the permissions before approving. To change accounts, change the account on the website opened by the authorization flow and reconnect the client; signing into a different website or development environment does not change an existing grant.

## What you are granting

| Scope           | What it allows                                                                                 |
| --------------- | ---------------------------------------------------------------------------------------------- |
| `guides:read`   | Read your trips and itineraries                                                                |
| `guides:write`  | Create trips; add, edit, move, and remove entries; record stays/events; change trip visibility |
| `bookings:read` | Read bookings and obtain your private booking-import address                                   |
| `saved:read`    | Read your lists and their contents; search place suggestions                                   |
| `saved:write`   | Create and publish lists; edit captions/sections; add and remove saved places                  |

The `guides:*` scope names cover trips and itineraries. Access to private records is limited to the authenticated account; knowing another user's trip ID does not grant access.

## Try it

* “Create a two-day São Paulo trip and add MASP on day one at 10:00.”
* “Move that visit to day two, keeping its time.”
* “Create a private saved list, then add a Museums heading.”
* In a new conversation: “Find that list and change MASP's caption.”

See [Tools](/tools) for the complete catalog, editing IDs, pagination, and explicit-null behavior.

## Sharing

Trips start as drafts and MCP-created saved lists start private. Ask explicitly to publish: `set_trip_visibility` controls a trip; `update_saved_list` controls a saved list. Public content can be shared and indexed. A returned URL does not itself indicate public visibility.

## Bookings

The assistant can read imported bookings and record stays or events. These tools do not purchase or cancel supplier reservations. There is no direct flight-add tool: forward a confirmation email to the address returned by `get_forwarding_address`. Keep that address private because mail sent there can add bookings to your account.

## Daily lookup budget

Paid place lookups have a **daily cap per user**, shared across the user's API tokens and connected clients. It resets at midnight UTC. A `429` response explains when to retry. Cached lookups do not add provider cost. Moving an existing entry does not resolve the place again; reads and itinerary corrections are separate from place discovery.

## Disconnect

On Stardrift, open **Profile → Connected apps → Disconnect**. The server rechecks grants with a cache of up to 60 seconds, so access may persist briefly before calls are rejected. Reconnect through your MCP client to grant access again.