Spree Commerce developer docs for AI agents
Spree Commerce docs for AI coding agents: build headless B2B and marketplace ecommerce on its APIs.
Luxury hotel search, rate comparison, booking quotes, and secure checkout handoff.
Pick the AI app you use, then copy the settings.
Passed 2/4 checks · What you ask goes through the maker’s server (bitvoya.com) · ✓ Commands checked Nov 13, 2026
First: which AI do you use?
Pick your app and the steps appear below.
Works with Claude · about 5 min
You need a Bitvoya MCP key (create it on the maker’s site) · Set it up once on claude.ai or the desktop app, then use it in chat · free accounts can add 1 · on Team/Enterprise an Owner adds it
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
How to get a key is in the maker’s README below
CustomizeConnectors
Copy each value into the field with the same name in Claude, then click Continue
Bitvoya MCPhttps://bitvoya.com/api/mcpUnder Request headers, add this name and value
AuthorizationBearer <paste your key here>Paste the key only into the app’s field, never into a chat or to anyone
Click Continue past the sign-in settings Claude detected · under Authentication choose what the maker says (Sign in now, Sign in when needed or No sign in), then click Add
+ConnectorsBitvoya MCP
Use Bitvoya MCP and tell me what you can do for me, then show me one thing✓ If Claude says it is using Bitvoya MCP or shows a Bitvoya MCP tool in the answer, you are connected
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
ChatGPT cannot connect Bitvoya MCP yet
Bitvoya MCP needs your own key to connect, but OpenAI’s help page only describes OAuth sign-in; there is no key option we could verify
A · Use an app that can connect Bitvoya MCP
B · Others in Online shops & payments that work with ChatGPT
Picked from the most used in the same category, only ones that connect by address with no key
Works with Claude Code · about 5 min
You need a Bitvoya MCP key (create it on the maker’s site)
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
How to get a key is in the maker’s README below
Mac: press Command+Space and type Terminal · Windows: open PowerShell
claude mcp add --transport http --scope user bitvoya https://bitvoya.com/api/mcp --header 'Authorization: Bearer your-value'Replace “your-value” with your key before pressing Enter
Paste the key only into the app’s field, never into a chat or to anyone
You should see Bitvoya MCP listed as connected
Use Bitvoya MCP and tell me what you can do for me, then show me one thing✓ If Claude Code says it is using Bitvoya MCP or shows a Bitvoya MCP tool in the answer, you are connected
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with Cursor · about 5 min
You need a Bitvoya MCP key (create it on the maker’s site)
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
How to get a key is in the maker’s README below
In the Bitvoya MCP settings, Authorization is empty; add your key and save
Paste the key only into the app’s field, never into a chat or to anyone
Use Bitvoya MCP and tell me what you can do for me, then show me one thing✓ If Cursor says it is using Bitvoya MCP or shows a Bitvoya MCP tool in the answer, you are connected
Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with VS Code · about 5 min
You need a Bitvoya MCP key (create it on the maker’s site)
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
How to get a key is in the maker’s README below
In the Bitvoya MCP settings, Authorization is empty; add your key and save
Paste the key only into the app’s field, never into a chat or to anyone
Use Bitvoya MCP and tell me what you can do for me, then show me one thing✓ If VS Code says it is using Bitvoya MCP or shows a Bitvoya MCP tool in the answer, you are connected
Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.
Address for apps that connect over the web
https://bitvoya.com/api/mcpJSON settings are under “For developers” below
Claude Code
claude mcp add --transport http --scope user bitvoya https://bitvoya.com/api/mcp --header 'Authorization: Bearer your-value'Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"bitvoya": {
"url": "https://bitvoya.com/api/mcp",
"headers": {
"Authorization": "Bearer your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"bitvoya": {
"type": "http",
"url": "https://bitvoya.com/api/mcp",
"headers": {
"Authorization": "Bearer your-value"
}
}
}
}These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.
Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.
Connect over the internet in
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast
The server asks you to sign in before it lists its tools.
We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 13, 2026
The registry name was verified against the domain bitvoya.com (the registry checks domain ownership)
Code last changed 7 days ago
Not applicable: a cloud server run by the owner of bitvoya.com; you don't run code from the repo
Refused access (HTTP 401) without offering OAuth sign-in. It may need a key, or it may be blocking bots; not confirmed.
Needs a key or token that you copy and paste yourself
Not checked yet; we read the tool list when we check the endpoint
Ask, share a tip or report that it does not work. Sorted by what people marked helpful.
No posts yet. Be the first to ask or share.
Posts here are written by users, not the PopNx team.
No reviews yet
Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.
It passed 2 of 4 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.
You need to fill in: Authorization
It runs in the maker’s cloud. Connect over the internet with nothing to install, but what you send passes through the maker’s servers.
The GitHub repo last changed 7 days ago, and the latest version (0.3.1) reached the registry 7 months ago.
Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT on the web (full MCP on Business and above; Pro read-only).
In the same category: Spree Commerce developer docs for AI agents, Stripe MCP, Sessy — Amazon SES observability
Servers in the same category from other makers, sorted by stars.
Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi
Spree Commerce docs for AI coding agents: build headless B2B and marketplace ecommerce on its APIs.
Stripe’s official server lets AI view and manage customers, products, payments and invoices. Connect to Stripe’s cloud and sign in with OAuth.
Read-only Amazon SES observability: search events, inspect bounces, pull delivery stats.
Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.
Luxury hotel intelligence and secure checkout handoff for AI travel agents.
Hosted public MCP for premium hotel discovery, benefit-rich rate comparison, quote preparation, and Bitvoya-controlled checkout completion.
Quick Start · Client Setup · Security Model · Secure Handoff · server.json
Public users connect to the hosted endpoint
https://bitvoya.com/api/mcpwith a Bitvoya-issued agent key fromDashboard -> Connect Agent. No self-hosting is required for normal usage.
Bitvoya is not a generic hotel feed wrapped in MCP. It is designed around luxury booking value and the handoff boundary real travel agents actually need.
| What Bitvoya does well | Why it matters for agents |
|---|---|
| Luxury-first hotel coverage | Better fit for high-end trip planning, concierge, and member travel flows |
| Structured benefits and promotions | Agents can explain breakfast, upgrade eligibility, late checkout, and property credits without scraping prose |
| Explicit pricing semantics | supplier_total_cny, service_fee_cny, and display_total_cny stay distinct |
| Secure checkout handoff | Card entry and payment stay on Bitvoya-owned surfaces instead of agent chat |
| Remote hosted MCP | Users connect directly over Streamable HTTP with bearer auth |
https://bitvoya.comDashboard -> Connect AgentDirect page:
https://bitvoya.com/dashboard/agent-keysUse the hosted endpoint:
https://bitvoya.com/api/mcpAdd this header:
Authorization: Bearer Minimal remote MCP configuration:
{
"type": "streamable_http", "url": "https://bitvoya.com/api/mcp", "headers": { "Authorization": "Bearer " } }
If you are testing manually outside an MCP client, also send:
Accept: application/json, text/event-streamExamples:
Search luxury hotels in Tokyo for next weekend and compare the best options.Find five-star hotels in Paris with breakfast and explain which rate has the best value.Prepare a booking quote for the strongest Shangri-La option in Singapore.Bitvoya works best when the driving model is strong at tool selection, stateful booking flows, and not hallucinating hotel details from prior knowledge.
Claude 4.6, GPT-5.4, or comparable flagship reasoning modelsstart_travel_planningstart_hotel_search remains the hotel-specific fast pathClient-specific setup guides are in docs/public/CLIENT_SETUP.md.
| Client | Remote MCP | Notes |
|---|---|---|
| Cherry Studio | Yes | Use the wrapped import shape plus manual Authorization header entry |
| Cursor | Yes | Works with mcp.json and environment-backed bearer auth |
| Windsurf | Yes | Remote Streamable HTTP with custom headers |
| Claude Code | Yes | Use claude mcp add --transport http |
| GitHub Copilot CLI | Yes | Configure as remote HTTP MCP |
| Goose | Yes | Use the remote MCP endpoint and bearer header |
Bitvoya MCP is designed for discovery, comparison, quote preparation, and secure completion handoff.
| Workflow | Primary tools |
|---|---|
| Generic first-step routing | start_travel_planning |
| City and hotel discovery | start_hotel_search, search_hotels, compare_hotels |
| Hotel detail and room/rate exploration | get_hotel_detail, get_hotel_rooms, compare_rates |
| High-level booking start | create_booking |
| Quote preparation | prepare_booking_quote |
| Booking intent creation | create_booking_intent |
| Order and handoff state polling | get_booking_state |
Bitvoya is strongest when the traveler cares about premium stay value instead of just the lowest visible headline rate.
USD 100 property creditstay 3 pay 2 and stay 4 pay 3 can materially change effective valueBenefit availability still depends on hotel, rate, market, and stay dates. Returned hotel and rate payloads should always be treated as the source of truth.
Bitvoya intentionally keeps sensitive execution on Bitvoya-hosted surfaces.
get_booking_state.Public agents do not directly own:
That boundary is deliberate. It keeps the public MCP useful without pushing payment risk or card handling into third-party chat tools.
Agents should present pricing carefully.
supplier_min_price_cny as indicative discovery pricingget_hotel_roomsget_hotel_rooms returns:supplier_total_cnyservice_fee_cnydisplay_total_cnydisplay_total_cny is the guest-facing total aligned with current Bitvoya product behaviorThis repository is licensed under Apache-2.0. See LICENSE and NOTICE.
The open-source license covers this repository's code and docs. It does not grant access to:
Connect Agent