Fortrip MCP Server

Fortrip MCP

An open-source, locally runnable MCP server for hotel search, live room rates, hotel details and booking payment links through Fortrip. It uses stdio and works with MCP clients that launch local commands.

Quick start

Requires Node.js 22 or newer, npm, and a Fortrip account for hotel API calls.

git clone https://github.com/FortripEngineering/fortrip-mcp.git
cd fortrip-mcp
npm ci
npm run build
npx -y fortrip login

The login command belongs to the separately maintained Fortrip CLI. Complete its browser login. This server reads the resulting credentials; it does not modify them. You can instead provide a CLI token with FORTRIP_TOKEN.

Configure your MCP client using the absolute path to this checkout:

{
  "mcpServers": {
    "fortrip-local": {
      "command": "node",
      "args": ["/absolute/path/to/fortrip-mcp/dist/index.js"]
    }
  }
}

Use this entry in Claude Desktop's MCP configuration or Cursor's .cursor/mcp.json. If your desktop app cannot find node, use its absolute executable path. The MCP process waits for JSON-RPC on stdin; running npm start in a terminal alone does not open a chat interface.

For Codex, add this to ~/.codex/config.toml:

[mcp_servers.fortrip-local]
command = "node"
args = ["/absolute/path/to/fortrip-mcp/dist/index.js"]

For Claude Code:

claude mcp add --transport stdio fortrip-local -- node /absolute/path/to/fortrip-mcp/dist/index.js

This repository is runnable from source. An npm release of fortrip-mcp has not been published; use the checkout instructions above.

Tools

Example prompts:

• “Find a hotel in Tokyo for November 10–12, 2026, for two adults, then compare live rates.”
• “Compare three hotels near this location with breakfast and free cancellation.”
• “Use the room I selected to prepare a payment link, and show me all accepted terms first.”

Search prices are indicative; availability and quotes come from get_rates. Rooms and adults per room are separate inputs. Provide each child's age. Rates default to CNY and also support USD. get_rates defaults to five rooms per hotel and can take about 15 seconds.

create_booking creates an order but does not charge a card. It returns a Fortrip page that shows booking terms and continues to Stripe. The assistant must show amount, currency, meals, cancellation, confirmation and any fees, then obtain confirmation before sharing the link. Links are private; do not post them in issues or logs. Cancellation and modification are not supported by this server. API access needs a Fortrip account, and hotel purchases have the prices and conditions shown at checkout.

Authentication and configuration

Saved credentials are read from $XDG_CONFIG_HOME/fortrip/credentials.json (normally ~/.config/fortrip/credentials.json) and selected by API origin. They are re-read on each call, so logging in again does not require a restart. Expired or missing credentials produce a tool error with login instructions. Do not commit tokens. If you set an explicit token, it will be sent to the configured API origin; only configure an origin you trust.

The server sends the tool's hotel/traveller inputs and bearer token to Fortrip over HTTPS. It stores no bookings or traveller data locally. Fortrip performs authentication, pricing, booking validation and payment handling. Tool results are returned to your MCP client and its model provider according to that client's settings. Logs and errors do not intentionally print credentials.

Relationship to the hosted MCP and CLI

This repository has its own code, tests and release cycle. It implements MCP over local stdio and calls Fortrip's existing authenticated hotel HTTP APIs. It is not a second booking backend and does not run the Fortrip website.

The hosted MCP at https://fortrip.ai/api/mcp continues to use Clerk OAuth. Use it directly in clients that support remote OAuth MCP; see the hosted MCP setup guide for configuration examples. CLI tokens cannot be used as credentials for that hosted MCP endpoint.

• This repo: runnable local MCP server, intended for Glama's Server directory.
• Hosted MCP: existing Glama Connector.
• Fortrip CLI: separately maintained command-line interface and login utility.

Configure either local or hosted MCP in a given client to avoid duplicate tool listings. Both access the same Fortrip service; available account data depends on the account used to log in.

Docker

docker build -t fortrip-mcp .
docker run --rm -i -e FORTRIP_TOKEN fortrip-mcp

Set FORTRIP_TOKEN in the launching environment first. Do not put it in the Dockerfile or image. The image runs as an unprivileged user; no port is needed. Without credentials, initialization, tool discovery and the planning guide still work, while hotel API calls explain how to log in.

Development and support

npm ci
npm run build
npm test
npm pack --dry-run

The server is written in TypeScript with strict type checking. Run npm run typecheck to build the server and strictly check the TypeScript tests. npm test compiles the tests into .test-build/ and runs them against dist/. Both output directories are ignored by Git. Tests exercise the actual stdio process, tool routing, schema validation, credential scoping, API failures and payment-link handling using mock API responses. They do not make live bookings. CI runs on Node.js 22 and 24. The Dockerfile is provided for directory builds and local container use.

Tool schemas follow the Fortrip HTTP API contract. When that contract changes, update schemas, descriptions and tests here together. Business rules and supplier integrations remain on the backend.

Report bugs and request help through GitHub Issues. Never include access tokens, private payment URLs, passport details or other traveller information in a public issue.

License

MIT, copyright 2026 FortripEngineering. The planning guide is adapted from the MIT-licensed Fortrip CLI. This license covers the repository's code and documentation; using the hosted service is subject to its own terms.