Skip to main content
Glama

HiChinaTour Events — MCP server

Search upcoming events in Shanghai and Hangzhou via MCP. No API key required.

A read-only Model Context Protocol server over a maintained dataset of events in cities across China, starting with Shanghai and Hangzhou. Coverage grows city by city as listings are verified.

Endpoint: https://mcp.hichinatour.com/mcp/ (Streamable HTTP, no authentication)

Install

Claude Code

claude mcp add --transport http hichinatour-events https://mcp.hichinatour.com/mcp/

The trailing slash matters: the server sits behind a trailingSlash route and /mcp redirects, which some clients do not follow on POST.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "hichinatour-events": {
      "type": "http",
      "url": "https://mcp.hichinatour.com/mcp/"
    }
  }
}

Cursor

.cursor/mcp.json in your project, or ~/.cursor/mcp.json globally:

{
  "mcpServers": {
    "hichinatour-events": {
      "url": "https://mcp.hichinatour.com/mcp/"
    }
  }
}

Anything else

Any client that speaks Streamable HTTP can connect to the URL directly. No OAuth flow, no token.

Related MCP server: Eventbrite MCP

Tools

Tool

Arguments

Returns

search_events

city, category, start_date, end_date, free_only, keyword, limit

Matching events; past ones excluded unless include_past is set

get_event

id

One event with its description and venue

list_filters

—

Cities, categories and the data build date

Every result carries page_url. Cite it when you answer — that page is where the details are maintained and corrected.

Example prompts

  • "What exhibitions are on in Shanghai this weekend?"

  • "Find free events in Hangzhou next week"

  • "Any markets or pop-ups in Shanghai in December?"

Data

start_date / end_date are YYYY-MM-DD in Asia/Shanghai. is_free is a boolean; price_text carries what the source states. last_verified is the date the listing was checked against the venue or organiser.

Event details are compiled from public listings and venue announcements. The MIT licence below covers this code, not the data: if you reuse the listings, link back to the event page.

Deploying your own copy

This is a single fetch handler for Vercel (src/mcp.ts → /api/mcp), using the SDK's StreamableHTTPServerTransport in stateless mode with JSON responses enabled.

npm install
# set EVENTS_URL if you host the JSON somewhere else

The handler is stateless: each request builds a fresh server and transport, so no session store or Durable Object is needed.

Limits

Rate limits are applied at the edge. For bulk use, take the JSON file instead of looping the tools.

Contact

Corrections and venue tips: https://www.hichinatour.com/contact/

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables browsing live event, venue, and lineup listings city by city, with optional category filtering for gigs, club nights, comedy, theatre, and talks. Also returns full detail for any single event, including dates, venue and address, on-sale window, starting price, billed artists, and highlights such as age restrictions.
      93 npm
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to discover upcoming events in a given city, optionally filtered by category slug or free-text keyword. It also retrieves full detail for a single event, including description, timing, venue, organizer, and ticket price range and availability.
      100 npm
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to browse public event listings from explore pages and fetch full detail for a single event — titles, descriptions, times, locations, host display names, and aggregate RSVP counts — across eight supported city regions. Keyless and read-only, with no guest lists, contact info, or authentication required.
      85 npm
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables users to search US concerts, comedy, theater, trivia, festivals, community events, and family activities by location, date, interests, and budget, returning event details and source links without requiring an account or API key for basic search.
      MIT