Server Model Context Protocol pubblico di Gopaxo: collega Claude, Cursor o il tuo agente IA a /api/mcp e confronta treno, autobus, carpooling e aereo in linguaggio naturale.
Accesso protetto da token : l'endpoint /api/mcp richiede un token Bearer personale. Richiedilo gratuitamente tramite il nostro modulo dedicato. Risposta via e-mail entro 2 giorni lavorativi.
Il Model Context Protocol è uno standard aperto pubblicato da Anthropic a fine 2024. Descrive un protocollo JSON-RPC 2.0 affinché un modello di linguaggio possa chiamare strumenti esterni, accedere a risorse e ricevere prompt strutturati. I principali client (Claude Desktop, Claude Code, Cursor, VS Code, Cline, Continue…) lo implementano nativamente.
In pratica, quando chiedi al tuo assistente «trovami un Paris-Lyon per domani a meno di 30 €», chiama lo strumento search_trips del nostro server, riceve una risposta JSON strutturata con tutti i viaggi disponibili e la presenta in forma leggibile — esattamente come se fossi su gopaxo.com.
L'accesso al MCP è subordinato a un token Bearer personale per proteggere i nostri vettori partner. Il token è gratuito e rilasciato su semplice richiesta in tre passaggi:
Nome, e-mail professionale, organizzazione e descrizione dell'uso previsto. La tua richiesta arriva a dev@gopaxo.com.
Esaminiamo la richiesta, generiamo un token univoco e lo aggiungiamo al registro dei token autorizzati. Tempo medio: meno di 2 giorni lavorativi.
Ricevi il token via e-mail. Incollalo nell'header Authorization del tuo client MCP — la configurazione dettagliata è più sotto.
Apri Impostazioni → Developer → Edit Config (o manualmente ~/Library/Application Support/Claude/claude_desktop_config.json su macOS), poi aggiungi:
{
"mcpServers": {
"gopaxo": {
"transport": "http",
"url": "https://www.gopaxo.com/api/mcp",
"headers": {
"Authorization": "Bearer VOTRE_TOKEN_GOPAXO"
}
}
}
}Riavvia Claude Desktop — i quattro strumenti Gopaxo appaiono nel menu «Available tools».
Un comando e l'MCP viene aggiunto al tuo progetto:
claude mcp add --transport http gopaxo https://www.gopaxo.com/api/mcp \
--header "Authorization: Bearer VOTRE_TOKEN_GOPAXO"Convalida poi in Claude Code con /mcp per elencare i server attivi.
Nel file .cursor/mcp.json (Cursor) o nella configurazione MCP di VS Code:
{
"mcpServers": {
"gopaxo": {
"url": "https://www.gopaxo.com/api/mcp",
"headers": {
"Authorization": "Bearer VOTRE_TOKEN_GOPAXO"
}
}
}
}Ricarica la finestra affinché l'agente rilevi gli strumenti.
Per esplorare il server senza integrazione preliminare, MCP Inspector apre un'interfaccia web di introspezione:
npx @modelcontextprotocol/inspector https://www.gopaxo.com/api/mcp \
--header "Authorization: Bearer VOTRE_TOKEN_GOPAXO"Lo strumento mostra l'elenco dei tools, il loro JSON-Schema e permette di eseguire chiamate di test.
Tramite l'SDK ufficiale @modelcontextprotocol/sdk:
import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
const transport = new StreamableHTTPClientTransport(
new URL("https://www.gopaxo.com/api/mcp"),
{
requestInit: {
headers: {
Authorization: `Bearer ${process.env.GOPAXO_MCP_TOKEN}`,
},
},
},
);
const client = new Client({ name: "my-agent", version: "0.1.0" });
await client.connect(transport);
// Find the cheapest Paris → Lyon for tomorrow
const trips = await client.callTool({
name: "search_trips",
arguments: {
from: "Paris",
to: "Lyon",
departureDate: "2026-04-25",
passengers: "adulte",
},
});
console.log(trips.structuredContent);Quattro strumenti coprono l'intero flusso Gopaxo, dalla risoluzione di una città alla proposta di un itinerario con prezzo. Tutte le operazioni sono in sola lettura (nessuna prenotazione lato MCP — la finalizzazione avviene sul sito del vettore partner tramite il link restituito).
Resolve a free-text city query to a list of Gopaxo / Tictactrip stops (city groups). Returns the 1-7 best matches, each with a human-readable label, an ISO-2 country code, and the gpuid needed for precise follow-up calls. Use this tool before `search_trips` whenever the user input is ambiguous or you need the canonical name.
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 2,
"description": "Free-text search, e.g. 'paris', 'bordeaux', 'london', 'bcn'. The Tictactrip autocomplete is fuzzy and accepts accents and partial names."
}
},
"required": [
"query"
],
"additionalProperties": false
}Compare all available outbound (and optional return) trips between two locations on a given date, across train, bus, carpool and plane partners. Returns normalised trips with price in euros, duration, provider, stops and a partner `redirectionLink` to finalise the booking.
{
"type": "object",
"properties": {
"from": {
"type": "string",
"description": "Origin city or station name (e.g. 'Paris', 'Lyon', 'Londres'). Prefer the label returned by the autocomplete tool for exact matches."
},
"to": {
"type": "string",
"description": "Destination city or station name."
},
"fromId": {
"type": "string",
"description": "Optional Tictactrip gpuid for the origin. When absent, the server resolves it via autocomplete."
},
"toId": {
"type": "string",
"description": "Optional Tictactrip gpuid for the destination."
},
"departureDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Date of the outbound trip in ISO 8601 (YYYY-MM-DD). Example: '2026-05-03'."
},
"returnDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Optional return date (YYYY-MM-DD). When provided, the response includes a `returnTrips` array. Omit for a one-way search."
},
"passengers": {
"type": "string",
"description": "Comma-separated passenger types. Allowed values: adulte, jeune, senior, enfant. Defaults to 'adulte' (1 adult).",
"default": "adulte"
}
},
"required": [
"from",
"to",
"departureDate"
],
"additionalProperties": false
}Return the cheapest price per day for a given origin/destination around a pivot date (±3 to ±5 days, as 3, 5, 7 or 11-day windows). Useful when the user wants to know if moving their trip by a day or two changes the price.
{
"type": "object",
"properties": {
"from": {
"type": "string",
"description": "Origin label."
},
"to": {
"type": "string",
"description": "Destination label."
},
"fromId": {
"type": "string",
"description": "Optional origin gpuid."
},
"toId": {
"type": "string",
"description": "Optional destination gpuid."
},
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Centre date (YYYY-MM-DD)."
},
"days": {
"type": "integer",
"minimum": 3,
"maximum": 11,
"default": 7,
"description": "Total window size centred on `date` (3, 5, 7 or 11 days)."
},
"passengers": {
"type": "string",
"default": "adulte",
"description": "Passenger composition (same format as search_trips)."
}
},
"required": [
"from",
"to",
"date"
],
"additionalProperties": false
}List the most popular destinations from (or to) a given city, using Gopaxo's curated Tictactrip top-cities dataset. Use this for inspiration when the user has only a starting city in mind.
{
"type": "object",
"properties": {
"uniqueName": {
"type": "string",
"description": "Tictactrip `unique_name` of the pivot city (for example 'paris', 'lyon', 'berlin'). Use autocomplete_cities to resolve."
},
"direction": {
"type": "string",
"enum": [
"from",
"to"
],
"default": "from",
"description": "Whether to list popular destinations *from* the city ('from') or popular origins *to* the city ('to')."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"default": 12,
"description": "Max number of destinations to return (1-50)."
}
},
"required": [
"uniqueName"
],
"additionalProperties": false
}Scrivici a contact@gopaxo.com: integrazione di prodotto, rate limit aumentati, co-marketing o semplice feedback sull'MCP.
Contattaci