TourClaim by Copernican MCP server

tourclaim

Python CLI, SDK and MCP server for credit-card travel insurance claims, with a companion Node CLI.

Command-line client for TourClaim by Copernican. Give your app, assistant, or terminal a travel-claim workflow: save a traveler’s answers, collect the evidence they choose to share, hand them the authorization to sign, and follow their claim. Works with any assistant that can run shell commands or call the API; no enrolled tour operator or booking-platform integration is required.

Review mode. The TourClaim connector API currently runs in review mode: it creates synthetic claims and files nothing with an insurer. Use fictional booking and medical data only. tourclaim status shows the current mode, and every intake and claim the API returns says which mode it came from.

For developers, agents, and platforms

TourClaim’s service reviews credit-card travel benefits, organizes receipts and cancellation evidence, coordinates medical-provider evaluation when needed, and handles claim preparation, filing, and follow-up. A traveler can bring a flight, hotel, or tour booking directly. Coverage, reimbursement, and clinical documentation depend on the relevant benefit administrator or provider.

The package exposes saved intake, selected email and file evidence, traveler authorization, submission to Copernican, and status. The API and both CLI editions currently use synthetic review mode: no insurer filing, payment, or clinical service is triggered. To start a real claim today, the traveler uses the online claim form, where they supply their documents and payment details securely.

• Terminal agents: use either CLI with --json; the traveler approves sign-in and signs in their own browser.
• Python applications: use tourclaim.Client from the Python edition.
• Platforms and tool-calling assistants: use the developer guide and OpenAPI schema.

Muse is one integration of these capabilities and is under review; it is not required to use this package. Existing /muse URLs and key formats are compatibility details and continue to work. Each connection acts for one traveler, not an operator or a platform-wide account.

What it does

TourClaim files trip cancellation and interruption claims against the travel benefits of a traveler's credit card. This tool drives TourClaim's connector API on behalf of one traveler:

1. Sign in. The traveler opens the sign-in page in their own browser, types the code shown in the terminal, and approves. The tool saves a key that belongs to that traveler.
2. Start a draft with whatever the traveler has said, then answer the questions the API says are still open.
3. Add evidence the traveler chooses to share: receipts, itineraries, a doctor's note they already have, and booking or cancellation emails.
4. The traveler signs. They review the draft and sign an authorization in their own browser. This tool cannot sign for them.
5. Submit the signed draft, then check the claim's status.

Nothing in this tool or the API decides whether a loss is covered, or promises reimbursement or a medical note. Copernican charges a 10% fee only when a claim is reimbursed; no payment is taken through this tool. Only bookings charged in US dollars are supported.

For AI agents, read AGENTS.md before driving this tool.

Install

The published Python CLI and SDK require Python 3.9+. The ordinary CLI has no runtime dependencies.

pip install tourclaim
tourclaim --help
# Or: uvx tourclaim --help

Shortened. The full README is on GitHub.