# Fortrip Docs

> Connect an AI agent to Fortrip to search, price and book hotels.


## Get started

- [Introduction](https://docs.fortrip.ai/index.md): Fortrip gives AI agents hotel search, live offers and orders. Your agent finds and prices the stay; the user reviews the terms and pays.
- [Quickstart](https://docs.fortrip.ai/quickstart.md): Use Fortrip from your AI app. Chat apps connect with no install; coding agents add a skill. Then ask for a stay and pay when you're ready.
- [API quickstart](https://docs.fortrip.ai/api-quickstart.md): Book a stay over HTTP in five steps, then each call in curl, TypeScript and Python. Every example is a file checked against the contract.
- [Installation](https://docs.fortrip.ai/install.md): Install Fortrip as an agent skill, a CLI, a remote MCP server with OAuth, or a local stdio MCP server, and set it up in your client.

## Guides

- [How search works](https://docs.fortrip.ai/search.md): Search never guesses. A name resolves by a published rule, an ambiguous one is an error that lists the candidates, and every answer says what it covered.
- [Orders and payment](https://docs.fortrip.ai/payments.md): From a live offer to a confirmed booking. Create the order, confirm it with the user, take payment one way, then follow the order until the hotel confirms. Cancel a paid order, or close an unpaid one.
- [FAQ](https://docs.fortrip.ai/faq.md): Fees and terms, testing an integration, your account, getting help, and whether an agent can pay without the user.

## Reference

- HTTP API
  - [HTTP API](https://docs.fortrip.ai/api.md): Fortrip API v1 is the HTTP API behind the MCP tools and the CLI. Each endpoint takes the same input as its MCP tool and answers the same object.
  - Reference
    - [Search hotels](https://docs.fortrip.ai/api/reference/search_hotels.md): Finds hotels in a place, around a point, in a country or by name, with an indicative price when you give dates. It only reads: nothing is booked or held.
    - [Hotel details](https://docs.fortrip.ai/api/reference/get_hotel.md): Shows one hotel's details: address, check-in and check-out times, description, policies, amenities and, on request, its room types. It only reads, and has no prices.
    - [Live offers](https://docs.fortrip.ai/api/reference/get_hotel_offers.md): Gets the live, bookable offers for one stay at the hotels you name: the total, meals, cancellation terms and confirmation of each. It only reads: nothing is booked or held.
    - [Create order](https://docs.fortrip.ai/api/reference/create_order.md): Creates an unpaid order from one offer, with the guests and a contact. Nothing is charged: the order waits for the user to pay it, on the page its payment link opens.
    - [Get order](https://docs.fortrip.ai/api/reference/get_order.md): Shows one of the user's orders: its status, payment, stay and terms, and what can be done to it now: pay, cancel or close. It only reads.
    - [List orders](https://docs.fortrip.ai/api/reference/list_orders.md): Lists the user's orders, newest first, a page at a time. It only reads.
    - [Cancel order](https://docs.fortrip.ai/api/reference/cancel_order.md): Cancels a paid order under its cancellation terms, once the user agrees to the penalty and the refund. Or closes an unpaid order the user no longer wants, with nothing charged.
    - [Pay order](https://docs.fortrip.ai/api/reference/pay_order.md): Pays a USD order with a Link token, a shared payment token the user approves in their Stripe Link wallet. Paying by the order's payment link needs no call.
    - [Account](https://docs.fortrip.ai/api/reference/me.md): The signed-in user the access token belongs to: their id, email and name.
    - [OAuth sign-in settings](https://docs.fortrip.ai/api/reference/auth_config.md): Where and how a client signs in with the device authorization flow. It needs no access token.
- MCP server
  - [Overview](https://docs.fortrip.ai/mcp.md): Search hotels, compare live offers and create orders with a payment link from any MCP client. Each tool answers in text, and matches a CLI command and an HTTP endpoint.

  - **Hotels**
  - [Search hotels](https://docs.fortrip.ai/mcp/search-hotels.md): Finds hotels in a place, around a point, in a country or by name, with an indicative price when you give dates. It only reads: nothing is booked or held.
  - [Hotel details](https://docs.fortrip.ai/mcp/get-hotel.md): Shows one hotel's details: address, check-in and check-out times, description, policies, amenities and, on request, its room types. It only reads, and has no prices.
  - [Live offers](https://docs.fortrip.ai/mcp/get-hotel-offers.md): Gets the live, bookable offers for one stay at the hotels you name: the total, meals, cancellation terms and confirmation of each. It only reads: nothing is booked or held.

  - **Orders**
  - [Create order](https://docs.fortrip.ai/mcp/create-order.md): Creates an unpaid order from one offer, with the guests and a contact. Nothing is charged: the order waits for the user to pay it, on the page its payment link opens.
  - [Get order](https://docs.fortrip.ai/mcp/get-order.md): Shows one of the user's orders: its status, payment, stay and terms, and what can be done to it now: pay, cancel or close. It only reads.
  - [List orders](https://docs.fortrip.ai/mcp/list-orders.md): Lists the user's orders, newest first, a page at a time. It only reads.
  - [Cancel order](https://docs.fortrip.ai/mcp/cancel-order.md): Cancels a paid order under its cancellation terms, once the user agrees to the penalty and the refund. Or closes an unpaid order the user no longer wants, with nothing charged.
  - [Pay order](https://docs.fortrip.ai/mcp/pay-order.md): Pays a USD order with a Link token, a shared payment token the user approves in their Stripe Link wallet. Paying by the order's payment link needs no call.
- CLI
  - [Overview](https://docs.fortrip.ai/cli.md): Commands print compact text on stdout, or the response as one line of JSON with --json, and errors on stderr with a fixed exit code.

  - **Hotels**
  - [Search hotels](https://docs.fortrip.ai/cli/hotels-search.md): Find hotels in a place, near a point or by name, with indicative prices.
  - [Hotel details](https://docs.fortrip.ai/cli/hotels-get.md): Hotel details: description, policies, amenities and room types.
  - [Live offers](https://docs.fortrip.ai/cli/hotels-offers.md): Live bookable offers for up to 15 hotels.

  - **Orders**
  - [Create order](https://docs.fortrip.ai/cli/orders-create.md): Create an unpaid order for an offer, with a payment link.
  - [Get order](https://docs.fortrip.ai/cli/orders-get.md): Show an order and its status.
  - [List orders](https://docs.fortrip.ai/cli/orders-list.md): List your orders, newest first.
  - [Cancel order](https://docs.fortrip.ai/cli/orders-cancel.md): Cancel a paid order under its terms (--max-penalty), or close an unpaid one (--close).
  - [Pay order](https://docs.fortrip.ai/cli/orders-pay.md): Pay an order with a Link token (US and Canada), instead of its payment link.

  - **Account**
  - [Sign in](https://docs.fortrip.ai/cli/login.md): Sign in through the browser.
  - [Sign out](https://docs.fortrip.ai/cli/logout.md): Revoke and forget the saved token.
  - [Account](https://docs.fortrip.ai/cli/whoami.md): Show the signed-in account.

  - **Local MCP**
  - [Local MCP server](https://docs.fortrip.ai/cli/mcp.md): Run an MCP server over stdio for local clients, bridged to Fortrip's hosted server.
- [Response schemas](https://docs.fortrip.ai/schemas.md): Each object below is what the HTTP API answers and what the CLI prints with --json. An MCP tool returns the same answer as text.
- [Errors & limits](https://docs.fortrip.ai/errors.md): The HTTP API, the MCP tools and the CLI share one error envelope, one set of codes and the same limits.
- [Enabled regions](https://docs.fortrip.ai/regions.md)
- [Changelog](https://docs.fortrip.ai/changelog.md): What changed for callers of the API, the MCP tools, the CLI and the contract, release by release.

## OpenAPI

- [OpenAPI 3.1.1 document](https://docs.fortrip.ai/openapi.json): the HTTP API's every request and response.