Sorted Travel Docs

travel.sortedPublished by sorted.travelOfficial publisherv1.2.0Updated Nov 7, 2026

Search Sorted Travel developer docs for MCP, API, SDK, and auth questions.

VerifiedStreamable HTTPWeb executableKnowledge & MemoryDeveloper Tools

Overview

AI-generated overview

Read-only MCP server that lets an assistant search and read Sorted Travel developer documentation on API, SDK, auth and MCP topics.

What you can do
  • Search documentation and get ranked excerpts with public URLs
  • List documentation pages with path, title, description and URL, optionally filtered by keyword
  • Load a single documentation page as markdown by path, such as overview, mcp, rest-api, sdks or auth
When to use it
Useful when an assistant needs to answer how-to or reference questions about integrating with Sorted Travel, such as connecting to its MCP server, calling the REST API, using an SDK or handling authentication. It is not for destination ranking, visa checks or profile updates.
Requirements
Remote streamable HTTP endpoint at sorted.travel; no authentication, environment variables or headers are declared. Network access to the endpoint is required.
Before you install
The server describes itself as read-only and does not rank destinations, check visas or update profiles; those actions belong to a separate product MCP. Excerpts and pages come from third-party documentation, so cite the returned public URL rather than treating content as authoritative.

Installation

In SourceWeft

  1. Open Sorted Travel Docs in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/travel.sorted%2Fdocs/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "sorted-travel-docs": {
      "type": "http",
      "url": "https://sorted.travel/docs/mcp"
    }
  }
}

README

sorted-travel

[skills.sh]

Official Python, JavaScript, Go, and Ruby SDK and CLI for the Sorted Travel REST API.

This repository publishes:

This is a stdlib-only Python client and a zero-dependency JavaScript client for the public endpoints at https://sorted.travel. Destination ranking, facts, weather, and visa tools are a free tier with zero-auth access. An API key is optional.

Agent skills (skills.sh)

Install Sorted Travel agent skills for Cursor, Claude Code, Codex, and other supported agents:

sh
npx skills add a-l-e-x-k/sorted-travel-sdk

Non-interactive install for Cursor:

sh
npx skills add a-l-e-x-k/sorted-travel-sdk -y -a cursor

Install one capability area:

sh
npx skills add a-l-e-x-k/sorted-travel-sdk --skill sorted-travel-weather
SkillUse when
sorted-travelWhere to go / ranked recommendations
sorted-travel-destinationsPlace facts for a named destination
sorted-travel-weatherForecast, climate, best months
sorted-travel-visaPassport visa hassle

They teach agents when to use Sorted Travel, how to connect the product MCP at https://sorted.travel/mcp and the docs MCP at https://sorted.travel/docs/mcp, and which tools to call. Groupings: skills.sh.json.

Connect MCP directly with mcp.json or Smithery:

sh
npx -y smithery mcp add sorted-travel/destinations

Install SDKs

Python:

sh
pip install sorted-travel

JavaScript:

sh
npm install sorted-travel

Go:

sh
go get github.com/a-l-e-x-k/sorted-travel-sdk/[email protected]

Ruby:

sh
gem install sorted-travel

Quickstart (Python)

python
from sorted_travel import Client
client = Client()print(client.status())page = client.list_destinations(limit=20)print(page["data"][0]["handle"], page["has_more"])

Destination tools need no key. If a host still requires one:

python
client = Client(api_key="st_sandbox_...")  # or set SORTED_TRAVEL_API_KEY

Self-serve sandbox keys:

python
payload = client.create_api_key()

Quickstart (JavaScript)

js
import { Client } from "sorted-travel"
const client = new Client()await client.status()await client.listDestinations({ limit: 20 })

Quickstart (Go)

go
import (	"context"
	"github.com/a-l-e-x-k/sorted-travel-sdk/go/sortedtravel")
client := sortedtravel.NewClient()client.Status(context.Background())limit := 20client.ListDestinations(context.Background(), nil, &limit)

Quickstart (Ruby)

ruby
require "sorted_travel"
client = SortedTravel::Client.newclient.statusclient.list_destinations(limit: 20)

CLI

sh
sorted-travel statussorted-travel destinations --limit 5sorted-travel sandboxsorted-travel api-key

JavaScript CLI via npm:

sh
npx sorted-travel status

Go CLI:

sh
go run ./go/cmd/sorted-travel status

Ruby CLI:

sh
sorted-travel status

Configuration

Constructor argEnvironment variableDefault
api_keySORTED_TRAVEL_API_KEY—
base_urlSORTED_TRAVEL_BASE_URLhttps://sorted.travel
timeout—30.0 seconds

Surface

  • status() — GET /api/v1/status
  • list_destinations(cursor=, limit=) — GET /api/v1/destinations
  • create_api_key() — POST /api/v1/api-keys
  • sandbox() — GET /sandbox
  • create_job(operation, **body) — POST /api/v1/jobs
  • get_job(job_id) — GET /api/v1/jobs/{job_id}
  • get(path, params=) / post(path, body=) — raw REST escape hatch

Interactive ranking, weather, and visa still go through MCP at https://sorted.travel/mcp. These SDK packages do not wrap JSON-RPC.

License

MIT. The Sorted Travel product remains under its own terms at https://sorted.travel/terms.

Source: README.md at commit 100f017

Tools

3

search_docs

Search Sorted Travel docs

Search Sorted Travel developer documentation for API, MCP, SDK, auth, and integration questions. Returns ranked excerpts with public URLs. Use this for how-to and reference questions. Do not use this tool to rank destinations or check visas — call the product MCP instead.

Parametersqueryrequiredtop_k

get_doc_page

Get Sorted Travel doc page

Load one Sorted Travel documentation page as markdown. Pass a path from search_docs or list_doc_pages such as overview, mcp, rest-api, sdks, or auth.

Parameterspathrequired

list_doc_pages

List Sorted Travel doc pages

List documentation pages on this docs MCP server, with path, title, description, and public URL. Pass query to filter by keyword; omit it to list every page.

Parametersquery

Version history

1
  1. v1.2.0LatestNov 7, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Sorted integrations

Sorted Travel

travel.sortedOfficial publisher

Sorted Travel lets an assistant rank destinations from a departure airport and pull place facts, weather, visa notes and saved traveler preferences.

Streamable HTTPWeb executable
Location & Lifestyle10 toolsNov 7, 2026