Vamos
Model Context Protocol

Connect Vamos to
Your AI Assistant

Control your São Paulo travel experience through natural conversation. Plan trips, manage tours, and run your platform — works with ChatGPT, Claude, Gemini, and any MCP-compatible AI.

Quick ConnectWhat is MCP?

What is MCP?

The Model Context Protocol is an open standard that lets AI assistants like Claude connect to external tools and data sources. Instead of switching between apps, you just ask Claude what you need and it works with Vamos directly.

Natural Language

No APIs to learn, no dashboards to navigate. Just describe what you want in plain English.

Real-Time Data

Every query hits the live Vamos database. Bookings, schedules, earnings — always up to date.

31 Specialized Tools

From browsing stops to bulk-assigning guides, the MCP server exposes the full Vamos platform.

Quick Connect — Copy & Go

No setup, no install. Just paste the config into your AI and start exploring São Paulo.

🟠

Claude

Desktop & Code

  1. 1. Open Settings → MCP Servers
  2. 2. Click "Add Server"
  3. 3. Paste config below
{
  "mcpServers": {
    "vamos": {
      "url": "https://vamoslocal.com/api/mcp"
    }
  }
}
🟢

ChatGPT

Desktop & Web

  1. 1. Open Settings → Connections
  2. 2. Click "Add MCP Server"
  3. 3. Paste the server URL
https://vamoslocal.com/api/mcp
🔵

Gemini

Desktop & Web

  1. 1. Open Settings → Extensions
  2. 2. Click "Add MCP Tool"
  3. 3. Paste the server URL
https://vamoslocal.com/api/mcp

Any MCP Client

Cursor, Windsurf, etc.

  1. 1. Open your MCP config file
  2. 2. Add a new server entry
  3. 3. Paste config below
{
  "mcpServers": {
    "vamos": {
      "url": "https://vamoslocal.com/api/mcp"
    }
  }
}

No authentication needed for tourist access. Guides and admins: scroll down for authenticated configs.

Choose Your Persona

Each role gets a tailored set of MCP tools. Pick yours and start chatting.

For Tourists

Plan your São Paulo trip with AI

Use natural language to explore stops, plan custom itineraries, find nearby attractions, and get details on any point of interest in São Paulo. Just talk to Claude and it handles the rest.

Explore São Paulo

Browse all curated stops and attractions

catalog_list
Plan My Trip

View and refine your personalized itinerary

itinerary_get
Stop Details

Get rich details on any point of interest

catalog_get
Available Cities

See which cities are available for tours

city_list
mcp.json
{
  "mcpServers": {
    "vamos": {
      "url": "https://vamoslocal.com/api/mcp"
    }
  }
}

For Guides

Manage your tours smarter

Access your schedule, review upcoming bookings, prep for tours, track your earnings, and chat with customers — all through a conversational interface with Claude.

My Bookings

View all your upcoming and past bookings

guide_my_bookings
My Schedule

See your weekly tour schedule at a glance

guide_schedule
Tour Prep Brief

Get AI-generated prep notes before each tour

guide_prep_brief
My Earnings

Track revenue, payouts, and financial insights

guide_earnings
mcp.json (guide)
{
  "mcpServers": {
    "vamos-guide": {
      "url": "https://vamoslocal.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
Sign in as Guideto get your Guide ID for the config

For Admins

Full platform control

Monitor the entire platform with real-time dashboards, manage the catalog, handle booking operations at scale, analyze revenue by guide, and maintain data integrity — all from your AI assistant.

Dashboard Stats

Real-time platform metrics and KPIs

dashboard_stats
Catalog Management

Full CRUD over stops, cities, and categories

catalog_list
Bulk Operations

Mass-assign guides or update booking statuses

booking_bulk_assign
Revenue Analytics

Revenue breakdowns by guide, period, and status

dashboard_revenue
mcp.json (admin)
{
  "mcpServers": {
    "vamos-admin": {
      "url": "https://vamoslocal.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
Contact for Admin Access

Setup in 3 Steps

Get up and running with the Vamos MCP server in under a minute.

1

Copy the Config

Pick your AI platform from the Quick Connect cards above and copy the config or URL.

# Claude / Cursor / Windsurf: copy the JSON config
# ChatGPT / Gemini: copy the server URL
https://vamoslocal.com/api/mcp
2

Paste in Your AI Settings

Open your AI tool's MCP or connection settings and paste what you copied.

# Claude Desktop: Settings → MCP Servers → Add
# Claude Code:    .claude/mcp.json
# ChatGPT:        Settings → Connections → Add MCP Server
# Gemini:         Settings → Extensions → Add MCP Tool
# Cursor:         Settings → MCP → Add Server
3

Start Chatting

Ask your AI about São Paulo tours. The Vamos tools activate automatically.

# Try these prompts:
"Show me the top food stops in São Paulo"
"Plan a 3-hour walking tour for 2 people"
"How much does a food tour cost for 4 people?"
"What's near the Municipal Market?"

All 31 MCP Tools

A complete reference of every tool available through the Vamos MCP server.

Catalog

  • catalog_list
  • catalog_get
  • catalog_create
  • catalog_update
  • catalog_delete
  • catalog_set_status

Cities

  • city_list
  • city_create
  • city_update
  • city_delete

Bookings

  • booking_list
  • booking_get

Itineraries

  • itinerary_get

Guides

  • guide_list
  • guide_create

Dashboard

  • dashboard_stats

Guide Actions

  • guide_my_bookings
  • guide_booking_detail
  • guide_prep_brief
  • guide_schedule
  • guide_earnings
  • guide_update_availability
  • guide_update_profile
  • guide_chat_send
  • guide_chat_history

Admin Actions

  • booking_bulk_assign
  • booking_update_status
  • dashboard_revenue
  • guide_performance
  • guide_update_admin
  • guide_delete

Ready to try it?

Pick a persona, copy the config, and start exploring São Paulo through your AI assistant. No GUI required.

Get Your ConfigLearn about MCP