AI 클라이언트가 전 세계 호텔을 검색하고 실시간 객실 요금을 비교하며, 안전한 예약 및 결제를 관리할 수 있도록 지원합니다.
다른 이름 FortripEngineering/fortrip
- 스타
- 1
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- 1.4.24
- 마지막 커밋
- 2026년 11월 14일
- 라이선스
- Apache-2.0
Fortrip MCP란?
Fortrip은(는) MCP server입니다. AI 클라이언트가 전 세계 호텔을 검색하고 실시간 객실 요금을 비교하며, 안전한 예약 및 결제를 관리할 수 있도록 지원합니다.
프로젝트 README에서 생성된 요약
Fortrip MCP server 정보
Fortrip는 AI 에이전트가 전 세계 호텔 예약을 처리할 수 있는 특화된 인터페이스를 제공합니다. 사용자는 통합 시스템을 통해 숙소를 검색하고, 실시간 객실 요금을 비교하며, 안전한 예약 및 결제를 관리할 수 있습니다. 이 서비스는 Claude Desktop, Cursor, Codex, Claude Code와 같은 AI 클라이언트 개발자와 사용자들을 위해 설계되었습니다.
사용자는 mcp.fortrip.ai의 hosted MCP server를 이용하거나 npx fortrip mcp 명령어로 로컬 브릿지를 실행하여 Fortrip와 상호작용할 수 있습니다. 인증은 브라우저 로그인을 통한 OAuth 방식으로 처리됩니다. 또한 시스템은 셸 기반 에이전트를 위한 CLI 도구와 Claude 및 OpenAI 플랫폼을 위한 전용 플러그인을 제공합니다. 이러한 멀티 서피스 접근 방식 덕분에 에이전트가 MCP 도구에 직접 접근할 수 있거나 셸 명령만 실행할 수 있는 환경이라도 복잡한 여행 계획 작업을 수행할 수 있습니다.
활용 사례
- 1복잡한 여행 계획에이전트가 숙박 분할이나 특정 예산 제한과 같은 고도화된 일정 요구 사항을 처리할 수 있습니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
Fortrip MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 Fortrip MCP 설치
$ claude mcp add fortrip -- npx -y fortripCursor에 Fortrip MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"fortrip": {
"command": "npx",
"args": [
"-y",
"fortrip"
]
}
}
}VS Code에 Fortrip MCP 설치
.vscode/mcp.json
{
"servers": {
"fortrip": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"fortrip"
]
}
}
}VS Code CLI에 Fortrip MCP 설치
$ code --add-mcp '{"name":"fortrip","type":"stdio","command":"npx","args":["-y","fortrip"]}'Claude Desktop에 Fortrip MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"fortrip": {
"command": "npx",
"args": [
"-y",
"fortrip"
]
}
}
}Codex에 Fortrip MCP 설치
$ codex mcp add fortrip -- npx -y fortripCodex config.toml에 Fortrip MCP 설치
~/.codex/config.toml
[mcp_servers.fortrip] command = "npx" args = ["-y", "fortrip"]
Gemini CLI에 Fortrip MCP 설치
$ gemini mcp add -s user fortrip npx -- -y fortripGemini settings.json에 Fortrip MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"fortrip": {
"command": "npx",
"args": [
"-y",
"fortrip"
]
}
}
}자동 검사
2026년 11월 14일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식
- 소스 저장소 연결 및 접근 가능fortripengineering/fortrip is public and reachablegithub.com/fortripengineering/fortrip ↗통과
- 패키지가 이 저장소를 소스로 명시fortrip names fortripengineering/fortrip as sourcenpmjs.com/package/fortrip ↗통과
- 빌드 출처(Sigstore 증명)Sigstore attestation for fortripnpmjs.com/package/fortrip/v/5.3.0#provenance ↗통과
- 오픈 소스 라이선스 (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-11-13github.com/fortripengineering/fortrip ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음No popular package one edit away from fortrip통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음the package checked; no critical advisoryosv.dev ↗통과
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답HTTPS endpoint answered 401 (sign-in required)통과
README
GitHub에서 보기Fortrip
Fortrip's public agent surface in one repository: the fortrip command-line
tool for hotel search, live offers and orders, the contract that every agent
surface shares, and the store listings that point agents at Fortrip. Hotels
only for now.
Everything here talks to Fortrip API v1, https://api.fortrip.ai/v1, or to the
hosted MCP server, https://mcp.fortrip.ai/, as a Fortrip user who has signed
in with OAuth in the browser.
Using Fortrip
-
From a shell, or an agent with one:
npx -y fortrip <command>. People start withnpx -y fortrip login. Agents sign in through theloginUrla command prints when it exits 3. The CLI's README has the commands, sign-in and exit codes. -
In an MCP client: connect the hosted server
https://mcp.fortrip.ai/if the client supports remote servers with OAuth, or run the local bridge,npx -y fortrip mcp. The CLI's README has the config for Claude Desktop, Cursor, Codex and Claude Code. The Claude and OpenAI plugins use the hosted server. -
In Claude Code, as a plugin (the hosted server plus Fortrip's skill):
/plugin marketplace add FortripEngineering/fortrip /plugin install fortrip@fortrip -
As a skill, for agents that can run shell commands but don't have Fortrip's MCP tools:
npx skills add FortripEngineering/fortrip --skill fortrip-cli
Layout
| Path | What it is | How it's published |
|---|---|---|
packages/contract |
The contract of Fortrip API v1: limits, paths, request and response schemas, error codes, field rules, the specs of the MCP tools and CLI commands, and the agent guide, written once and rendered for the MCP server, the Claude skill and the CLI | npm: @fortrip/agent-contract, from a v* tag on main, together with fortrip |
packages/cli |
The fortrip CLI: hotel search, live offers, orders and payment links from a shell, the local MCP bridge (fortrip mcp) |
npm: fortrip, from a v* tag on main, together with @fortrip/agent-contract |
plugins/claude |
Claude plugin (hosted MCP server + static skill, generated) | Submitted in the developer portal; .claude-plugin/marketplace.json at the root lets Claude Code add this repo as a marketplace |
plugins/openai |
ChatGPT / Codex plugin | Zip uploaded in the OpenAI portal |
plugins/registry |
MCP Registry entry | The Publish Fortrip to MCP Registry workflow |
skills/fortrip-cli |
Skill for agents with a shell (generated) | npx skills add FortripEngineering/fortrip --skill fortrip-cli reads it from main |
scripts |
Repo-wide scripts: generate.ts renders the skills, validate.mjs checks the listings |
Development
Node.js 22 or newer and pnpm 11.
pnpm install
pnpm test # tests of every package, and of the scripts
pnpm generate # renders the skills from the contract
pnpm generate --check # fails with a diff when a generated file is stale
pnpm build && pnpm validate # checks the store listings
pnpm typecheck and pnpm build run for every package too. CI runs
typecheck, tests and the build on Node.js 22 and 24, and on 24 also
pnpm generate --check, pnpm validate and claude plugin validate --strict
on ., plugins/claude and skills.
Generated files
The skills (SKILL.md and references/planning.md in
plugins/claude/skills/fortrip and skills/fortrip-cli) and the contract's
src/guide-data.generated.ts are generated. Never edit them: change the
guide's fragments in packages/contract/guide/*.md (or a skill's front
matter in scripts/generate.ts), run pnpm generate and commit the result.
The fragments say which surface states what, and the Claude skill, the MCP
instructions and the CLI's guide all render from them, so they cannot drift
apart.
Publishing
Claude plugin
plugins/claude is a plugin with two parts:
.mcp.jsonpoints at the hosted MCP server. On claude.ai and in Cowork it shows up on the plugin's Connectors tab, where users sign in with their Fortrip account (OAuth); Claude Code connects to it directly.skills/fortrip/is the generated skill that tells Claude how to use the tools: call order, occupancy per room, prices and currency, confirming before the payment link, and errors.references/planning.mdcovers flexible dates, budgets, split stays and several destinations.
The skill is self-contained: the directory doesn't allow a plugin to fetch
instructions at runtime (Software Directory Policy §2F), and its validator
blocks unpinned npx launchers, so the CLI skill stays outside
plugins/claude. pnpm validate fails if a file under it mentions npx,
fortrip@latest or get_planning_guide.
Submit the plugins/claude folder in the
developer portal. Check it with:
claude plugin validate --strict plugins/claude
claude plugin validate --strict .
The second command checks .claude-plugin/marketplace.json at the repository
root. It lists plugins/claude as a plugin, which lets npx skills add find
the plugin's skill next to skills/fortrip-cli, and lets Claude Code add this
repository as a marketplace.
Claude Code keeps users on the version in plugin.json, so bump it whenever
anything in plugins/claude changes, regenerated skill text included: patch
for wording, minor for new behaviour or components, major for changes that
break how people use it. The directory takes the listing icon from the first
submission only.
CLI skill
skills/fortrip-cli is the CLI's guide as a static skill: the agent reads the
commands, call order, sign-in and what to show the user before a payment link
from the skill itself. It needs Node.js 22 or newer and isn't part of the
Claude directory plugin.
npx skills add FortripEngineering/fortrip --skill fortrip-cli
OpenAI plugin
plugins/openai/plugin.json holds the listing copy and review test cases, and
mcp.json the hosted server URL. mcp.json follows the Agent Plugins schema
(type: streamable-http), while plugins/claude/.mcp.json follows Claude's
(type: http); both point at the same server. Build the upload:
cd plugins/openai && rm -f ../../fortrip-openai.zip && zip -rX ../../fortrip-openai.zip plugin.json mcp.json assets
Upload the zip in the OpenAI portal. The portal verifies the domain through
https://mcp.fortrip.ai/.well-known/openai-apps-challenge, served by mcp.fortrip.ai.
MCP Registry
plugins/registry/server.json lists Fortrip as
io.github.FortripEngineering/fortrip, with two ways to connect: the hosted
server (remotes) and the npm package fortrip, run as fortrip mcp
(packages; the mcpName in packages/cli/package.json must equal the
entry's name). The entry is published by its own workflow, Publish Fortrip to
MCP Registry (.github/workflows/publish-mcp-registry.yml), which runs only
from main and waits for a human to approve the mcp-registry environment.
To publish a change, bump version (a version can't go down), set
packages[].version to the CLI version on npm, merge to main and run the
workflow. After a CLI release, run it once npm has the new version.
To deprecate an old version, or make it active again, run Set an MCP
Registry version's status (.github/workflows/mcp-registry-status.yml)
with the version, the status and, when deprecating, a message (the publisher
takes none for active). It has the same main-only,
approval-gated setup. A personal mcp-publisher login github can't do this:
it only gets io.github.<user>/*, so the org namespace comes through this
repository's OIDC identity.
The Registry binds the server URL to one name, so a rename means deleting the old entry before publishing the new one.
Releasing
fortrip and @fortrip/agent-contract are released together, at the same
version.
-
In a PR, set
versionto the newX.Y.Zin bothpackages/cli/package.jsonandpackages/contract/package.json(npm version X.Y.Z --no-git-tag-versionin each package's directory), setpackages[].versioninplugins/registry/server.jsonto it too, and runpnpm generateand commit what it changes. Merge the PR intomainonce CI passes. -
Tag the merge commit on
mainand push the tag:git checkout main && git pull git tag vX.Y.Z && git push origin vX.Y.Z -
A human approves the
npm-publishenvironment. The workflowpublish.ymlthen publishes both packages to npm through trusted publishing (npm's OIDC sign-in from GitHub Actions, so no npm token is stored in GitHub), which gives them provenance. -
Once npm has the new version, run the MCP Registry workflow (above).
The workflow refuses a tag that isn't vX.Y.Z or vX.Y.Z-rc.N, that differs
from the version in either package.json, or that isn't on main. Its
build job runs typecheck, tests and the build and packs both tarballs; its
publish job, in the npm-publish environment, publishes those tarballs
(@fortrip/agent-contract first) without installing or building anything. A
release candidate, tagged vX.Y.Z-rc.N, is published under the next
dist-tag, so npm install doesn't pick it up. Rerunning the publish job after
a partial publish skips what is already on npm.
Docs
packages/docs is the Fumadocs site behind docs.fortrip.ai.
pnpm --filter ./packages/docs dev # local dev server
pnpm --filter ./packages/docs test # its tests
Production docs follow the live server, not main. A docs deploy is a
docs-* tag, and the order is:
- Tag
vX.Y.Z(npm, see Releasing above). - Ship the server release that pins that contract to production.
- Push the tag
docs-X.Y.Z. - A human approves the
docs-productionenvironment. The workflowdeploy-docs.ymlthen builds and deploys to Vercel.
The workflow refuses to deploy unless all of these hold at the tagged commit:
- the contract's version is a plain
X.Y.Z, not an rc; packages/contract/srcis unchanged since the tagvX.Y.Zof that version;- the changelog has the version's entry, dated, and no entry says "Not released yet.".
The tag name itself is free-form. So once main has moved on from the live
release (contract changes, or a new undated changelog entry), a docs deploy
can't go out from main: cut a short branch from the live v* tag, make the
docs-only fix there, tag docs-X.Y.Z-<n> on that branch and push the tag,
and also merge the fix to main. A docs-only fix needs no npm release and no
changelog entry.
Before tagging a stable release, replace the version's "Not released yet." with
"Released YYYY-MM-DD." in packages/docs/content/docs/changelog.mdx, or the
changelog gate fails.
One-time setup, by the owner:
- A Vercel project with Root Directory
packages/docs, framework Next.js, "Include files outside the root directory" left on (the build readspackages/contractandpackages/cli/package.json) and preview deployments on.packages/docs/vercel.jsonturns off Git deployments ofmain: production would otherwise followmainand skip the approval. Other branches still get previews. On the first real run, confirm a push tomaincreates no production deployment. Importing the project deploysmainonce anyway; the firstdocs-*deploy replaces it. - The
docs.fortrip.aidomain on that project, and Vercel Analytics enabled. - The GitHub environment
docs-production, with the same required reviewers asnpm-publish("Prevent self-review" off, as there, so whoever pushes the tag can approve), deployment branches and tags limited to the tag patterndocs-*, and the secretsVERCEL_TOKEN,VERCEL_ORG_IDandVERCEL_PROJECT_ID. - On the first deploy, confirm
vercel buildsucceeds withoutVERCEL_TOKEN: the workflow gives the token only tovercel pullandvercel deploy, since the build runs the dependencies' code.
License
Apache License 2.0. Copyright 2026 FortripAI, Inc. (see NOTICE). Releases before 2.0.0 were published under the MIT License. This license does not grant access to the hosted Fortrip service, hotel inventory, or third-party data.
Trademarks
"Fortrip" and the Fortrip logo are trademarks of FortripAI, Inc. The Apache License 2.0 does not grant permission to use the trade names, trademarks, service marks or product names of FortripAI, Inc., except as required for reasonable and customary use in describing the origin of the software and reproducing the content of the NOTICE file (section 6).
Fortrip MCP 질문
Fortrip MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add fortrip -- npx -y fortrip를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
Fortrip MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
Fortrip CLI로 무엇을 할 수 있나요?
CLI를 통해 셸 환경에서 호텔 검색, 실시간 특가 확인, 주문 및 결제 링크 관리가 가능합니다.
Fortrip의 인증 방식은 어떻게 되나요?
사용자는 브라우저에서 OAuth를 사용하여 Fortrip 사용자로 로그인합니다.