For developers

Build with Voyspark.
SDK, CLI, and MCP server.

Open-source toolkit to integrate flights, hotels, community, and trip planning into any application or AI agent. TypeScript, MIT, zero external dependencies in the SDK.

View on GitHubInstall now

What is the Voyspark toolkit?

A set of 3 open-source packages that connect your application or AI agent to the Voyspark platform — real-time flight search, hotels, traveler community, trip plan generation, and more. Type-safe, MIT-licensed, zero external dependencies in the SDK.

How it works

1. Pick an interface

SDK to use in TypeScript/JavaScript code. CLI to run from your terminal. MCP server to connect Claude Desktop, Cursor, Cline, or any AI agent.

2. Make the call

Search flights by IATA code, hotels by city, community posts by hashtag, generate complete trip plans from a prompt. Typed JSON responses.

3. Use the result

Every response includes booking URLs with embedded affiliate tracking. You earn without processing payments — commission paid by providers.

Everything the toolkit does

Complete access to the Voyspark platform across 3 interfaces.

Real-time search

  • Flights by IATA (Travelpayouts/Aviasales)
  • Hotels by city (Hotellook)
  • Car rentals (DiscoverCars)
  • Tours and experiences (GetYourGuide)
  • Trains, transfers, and travel insurance
  • Unified search (articles + destinations + users + posts + hashtags + communities)

Trip planning

  • Trip plan simulator: flight + hotel + itinerary combo
  • Estimated total cost calculation
  • Day-by-day itinerary generated by AI
  • Destination comparison (climate, cost, safety)
  • Best month to travel suggestion

Community & social

  • Public profiles (@username)
  • Traveler posts by hashtag
  • 7 themed communities (slow travel, foodies, family, solo women, off-the-postcard, miles hacking, sustainable)
  • Real trip reports
  • Travel genome (taste profile)

Editorial content

  • Journal articles in 7 languages
  • 60+ curated destination guides
  • AMP Web Stories
  • Free tools (Visa Checker, Carbon Calc, Best Month, etc.)

For developers

  • Type-safe TypeScript SDK, zero external deps
  • Color CLI binary with 4 commands
  • stdio MCP server for Claude Desktop/Cursor/Cline/Zed
  • OpenAPI 3.1 spec
  • schema.org JSON-LD on every entity
  • llms.txt + llms-full.txt + ai-plugin.json
  • Transparent IP rate limiting
  • Automatic affiliate tracking on every booking URL

Real-world use cases

Travel bot on Telegram/WhatsApp

A Claude agent that takes "find me a flight SP-Lisbon in July" and returns options with affiliate booking URLs. You earn per completed booking.

Travel plugin in Cursor/IDE

Dev asks "add a page with cheap flights to Tokyo" and Cursor calls voyspark_search_flights, receives structured data, and generates the component.

Concierge with Claude Desktop

Customer chats with Claude on Mac, Claude calls Voyspark tools and builds a complete trip plan with flights + hotels + itinerary in seconds.

Travel app on Next.js

Import @voyspark/sdk into your Next.js app, query unified search, community posts, and itineraries — all type-safe.

Three packages, one codebase

Same API. Three interfaces: code, terminal, AI agents.

@voyspark/sdk

TypeScript client for the public API. Works in Node 20+, Deno, Bun, and modern browsers. Type-safe, zero deps.

npm install @voyspark/sdk

@voyspark/cli

voyspark terminal binary. Search flights, hotels, community, and generate trip plans from your shell.

npx @voyspark/cli flights GRU LIS --depart 2026-07-12

@voyspark/mcp

MCP server for Claude Desktop, Cursor, Cline, Zed, and any Model Context Protocol client. 4 tools, 2 resources.

npx @voyspark/mcp

Quick start

SDK (code)

import { VoysparkClient } from '@voyspark/sdk';

const client = new VoysparkClient({ locale: 'en' });

const flights = await client.searchFlights({
  origin: 'GRU',
  destination: 'LIS',
  depart: '2026-07-12',
  return: '2026-07-26',
  adults: 2,
});

CLI (terminal)

npm install -g @voyspark/cli

voyspark search "lisboa"

voyspark flights GRU LIS \
  --depart 2026-07-12 \
  --return 2026-07-26 \
  --adults 2

MCP (Claude/Cursor)

// ~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "voyspark": {
      "command": "npx",
      "args": ["-y", "@voyspark/mcp"],
      "env": { "VOYSPARK_LOCALE": "en" }
    }
  }
}

Tools exposed via MCP

voyspark_search

Unified search across users, posts, hashtags, communities, articles, destinations.

voyspark_search_flights

Flight offers via Travelpayouts (Aviasales) with affiliate-tracked booking URLs.

voyspark_search_hotels

Hotel offers via Hotellook with affiliate-tracked booking URLs.

voyspark_build_trip_plan

Trip plan draft — combo flight + hotel + itinerary with cost breakdown.

Public endpoints

Documented in OpenAPI 3.1. IP rate-limited (10/min, 60/h). API key tier ships in 2026.

MethodPath
GET/api/search/spotlight
GET/api/search/flights
GET/api/search/hotels
POST/api/trip-plans/simulator

openapi.json

AI discoverability

AI agents discover Voyspark automatically.

llms.txt

llms-full.txt

openapi.json

ai-plugin.json

Pricing

Free

$0

IP rate limit, 10 req/min. Affiliate-tracked booking URLs.

Pro

Coming soon

API key, 100 req/min, priority support, webhooks.

Ready to build?

One npm install and you have flights, hotels, and the Voyspark community in your app.

View on GitHubInstall now

Community & support

Issues and discussionsContact the team