Command Line Interface

CLI for San Luis Way

Access San Luis Potosi data directly from your terminal — events, places, guides, weather, and more

Quick Start

Run a single command to query events, places, and more from SLP:

$ npx @sanluisway/cli events --limit 5 --json

Works with OpenClaw

The CLI is built on OpenClaw skills, meaning any AI agent or automation tool can discover and use the same commands programmatically. Browse available skills on ClawHub.

Browse skills on ClawHub

Installation

Global install

$ npm install -g @sanluisway/cli

On-demand (no install)

$ npx @sanluisway/cli --help

Command Reference

All available commands in the CLI:

CommandDescriptionKey Flags
eventsList upcoming events--limit, --category, --json
event <slug>Get event details by slug--json
placesList places by category--category, --limit, --json
place <slug>Get place details by slug--json
guidesList available guides--limit, --json
guide <slug>Get guide content by slug--json
outdoorList outdoor activities--limit, --json
cultureList cultural sites--limit, --json
weatherCurrent weather conditions--json
newsLatest local headlines--limit, --json
exchange-ratesCurrent exchange rates--json
search <query>Full-text search across all data--type, --limit, --json

Example Commands

Common usage patterns:

# List this weekend's events
npx @sanluisway/cli events --limit 10 --json

# Get details for a specific event
npx @sanluisway/cli event fenapo-2026

# Find restaurants in Centro Historico
npx @sanluisway/cli places --category restaurant --limit 5

# Get a specific place
npx @sanluisway/cli place cafe-tipico

# List travel guides
npx @sanluisway/cli guides

# Check the weather
npx @sanluisway/cli weather --json

# Get latest news
npx @sanluisway/cli news --limit 3

# Search across all data
npx @sanluisway/cli search "tacos al pastor"

# Get exchange rates
npx @sanluisway/cli exchange-rates

# Explore outdoor activities
npx @sanluisway/cli outdoor --limit 5 --json

JSON Output

Add --json to any command to get structured output. The response envelope looks like this:

{
  "ok": true,
  "data": [ ... ],
  "meta": {
    "total": 42,
    "limit": 5,
    "source": "sanluisway.com"
  }
}

CLI vs MCP

Choose the right tool for your workflow:

FeatureCLIMCP
Best forScripts, agents, CI pipelinesChat AI clients (Claude, Cursor)
Output formatJSON to stdoutStructured tool calling
Access methodDirect terminal commandsNatural language via AI
Discoverability--help on every commandAuto-discovered by AI clients
Setupnpx or npm installAdd to client config

Frequently Asked Questions

No. The San Luis Way CLI is completely free and requires no API keys, accounts, or tokens. Just run the command and get data.
Events, places (restaurants, cafes, bars, museums), guides, outdoor activities, cultural sites, weather, news, and exchange rates — all for San Luis Potosi.
Yes. Add --json to any command to get structured JSON output that you can pipe into jq, parse in scripts, or feed into other tools.
The CLI gives you direct terminal access for scripts and automation. The MCP server integrates into AI assistants for natural language queries. Both access the same data.