TravelPanda Connect

Your China trip, with your AI assistant.

Bring your saved trips into the conversation. Plan a new journey or review a change, then continue with the same account in the TravelPanda app.

Ask your AI assistant to help you connect. Keep your travel plans in one account and pick them up in the TravelPanda app.

One account. A connection you control.

  1. Use your TravelPanda account

    Sign in the same way you do in the app, or create an account on the website. You do not need to install the app to start planning.

  2. Ask your AI to help you connect

    Copy the message below into your assistant. Follow the available setup steps, then sign in on the TravelPanda page in your browser.

  3. Review access and start a conversation

    Check the app name, permissions and cumulative Bamboo allowance before connecting. Then tell your assistant what you would like to do. You can manage or disconnect the connection at any time.

One message to get started

Copy the message below into your AI assistant. It can read the official guide and help you choose an available way to connect.

Send this to your AI assistant

Please read the official guide at https://github.com/yuri-cong/travelpanda-connect and help me install or connect TravelPanda using the setup method this AI assistant supports. Guide me through signing in and let me know when the connection is ready. If you need me to do anything, walk me through it step by step.

Do I need to set anything up myself?

Some assistants can install connections for you; others guide you through their settings. Send the message above to your assistant and follow its instructions. You complete sign-in and review access in your browser.

Prefer to set up Codex yourself?

Install the TravelPanda plugin

If your Codex version supports plugins, run these two lines in a terminal. No GitHub account is needed. Then follow the sign-in prompt in your assistant.

codex plugin marketplace add https://github.com/yuri-cong/travelpanda-connect
codex plugin add travelpanda@travelpanda-connect

Advanced: connect without the plugin

1. Add the connection settings

Open .codex/config.toml in your home folder and add this section, keeping your other settings. If it already contains travelpanda, update that section instead. If you connected through the TravelPanda plugin, use that connection without adding a second one.

[mcp_servers.travelpanda]
url = "https://api-sg.travelpanda.ai/agent/mcp"
oauth_resource = "https://api-sg.travelpanda.ai/agent/mcp"
scopes = ["account:read", "trips:read", "trips:write", "bamboo:spend"]

[mcp_servers.travelpanda.oauth]
client_id = "travelpanda-codex"
callback_url = "http://127.0.0.1:5555/callback"
callback_port = 5555

2. Sign in securely

Run this command in a terminal on the same computer. In the browser that opens, sign in to TravelPanda and choose your permissions and cumulative Bamboo allowance. No API key is needed.

codex mcp login travelpanda

Codex connection guide

Once connected, you’re ready to go. Tell your assistant what you would like to do, whether that’s planning your first trip or continuing an existing one.

Know what you are allowing

Read your account and trips

The assistant can read the balance, membership and saved trips available to your connected account. Read-only access cannot generate or change a trip.

Create or preview changes

Generation uses Bamboo within the cumulative allowance you grant this connection. Some Bamboo is held when work begins, then settled against actual usage, with any unused hold released. The hold is not a fixed total price or a per-trip spending cap.

Choose which changes to keep

Generating a change preview uses Bamboo even if you do not keep it. Applying an existing preview requires your confirmation and does not generate or charge again. A newer trip version must be reviewed before applying conflicting changes.

Start with a simple request

Trip planning needs an internet connection and the relevant permissions and balance. TravelPanda does not book hotels, transport or tickets through this connection. Check opening times, availability and travel details before you go.

What is shared, and what stays under your control

This notice supplements the TravelPanda Privacy Policy for assistant connections. TravelPanda receives the travel requirements and tool requests sent by your assistant. Authorized account details, trip content, task results and usage information are returned to that assistant provider, which handles them under its own privacy policy.

TravelPanda processes this information through its cloud services and relevant AI and travel-data providers to generate, save and recover your trip. Only share travel information needed for the task; do not send passwords, payment-card details or identity documents.

For security, rate limiting, usage reconciliation and fault recovery, TravelPanda records request and task references, tool names, outcomes, timing and usage, with hashed account and connection identifiers. These tool-audit records exclude raw prompts, trip text, emails and access tokens. This does not describe all data stored to deliver the service.

Saved trips remain in your account until deleted. Temporary task data and authorization records follow service retention and expiry controls; necessary security and transaction records may remain for recovery, disputes or legal obligations. See the Privacy Policy for data requests and contact support for retention questions.

Disconnecting blocks future access and token refresh. It does not delete your account, erase information already received by your assistant, or automatically cancel or refund work already accepted. Manage connections below; request account deletion through the account support site.

If something needs attention

Access or balance is unavailable

Ask the assistant to explain the returned status. Check your permissions and connection allowance. An unknown balance is not zero; wait and retry the check when the service recovers.

A request was interrupted

Ask for the status of the original task. Do not start the same generation again while its result or charge is uncertain.

Your assistant cannot connect

Ask it to check the supported options in the official guide. If it cannot install connections itself, follow the manual steps for a supported assistant. If a supported connection still fails, send support the error without passwords or tokens.

[email protected]