# CUQU找搭子 (CUQU) MCP Server

> CUQU找搭子 (CUQU) MCP Server is a free MCP server for events and entertainment. Find and book offline group activities in 10+ cities, or publish your own, via CUQU. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API, CLI, self-hosted
- **Website:** https://cuqu.net
- **Repository:** https://github.com/cuqu-net/cuqu-skill
- **MCP Registry name:** io.github.cuqu-net/cuqu-mcp
- **Categories:** events and entertainment
- **Listing updated:** 2026-11-16

## About

CUQU is a Chinese platform for meeting people in person around shared interests: board games, frisbee, hiking, badminton, anime events and 100+ other categories, operated by Guangtian Technology (Shenzhen). Bookings happen through a WeChat mini-program, and this server gives agents access to the live activity list.

The README lists eight tools. Four are read-only with no key: searching activities, a full activity card, a partner venue directory and a share link. Four write tools need a key: create an activity, register a user, create a WeChat Pay order and check in on site. The site stresses that the agent only finds and recommends, and payment returns to the person to confirm.

It is a zero-dependency Python server over stdio, also hosted at agent.cuqu.net. The site is mostly in Chinese and covers Shenzhen, Guangzhou, Shanghai, Beijing, Hong Kong, Macau and Singapore.

## Features

- **Activity search:** Find live events by type, city and date.
- **Activity cards:** Full details such as time, venue, price and booking progress.
- **Venue directory:** Browse partner venues with capacity and per-head price.
- **Booking and check-in:** Register users and check in on site with an API key.
- **Organizer publishing:** Create new activities as an organizer.
- **WeChat Pay orders:** Create payment orders for bookings.

## Good for

- Find a board game session in Nanshan this weekend
- Book a spot in a hiking group
- Publish an activity as an organizer
- Look up a venue's capacity and price

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http cuqu-mcp https://agent.cuqu.net/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://agent.cuqu.net/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "cuqu-mcp": {
      "url": "https://agent.cuqu.net/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "cuqu-mcp": {
      "type": "http",
      "url": "https://agent.cuqu.net/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "cuqu-mcp": {
      "serverUrl": "https://agent.cuqu.net/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "cuqu-mcp": {
      "type": "http",
      "url": "https://agent.cuqu.net/mcp"
    }
  }
}
```

## Tools

- `query_activities`: Search live activities by type, city and date.
- `get_activity_card`: Full detail card for one activity.
- `query_venues`: Curated partner venue directory.
- `generate_urllink`: Share link and WeChat mini-program path for an activity.
- `create_activity`: Organizer publishes a new event.
- `register_event`: Book a user into an activity.
- `create_payment`: Create a WeChat Pay order for a booking.
- `check_in`: On-site check-in or redemption.

## FAQ

### Is it free?

Basic matching and registration are free; some activities charge venue costs per session.

### Do I need a key?

Read tools need none; write tools need a CUQU_API_KEY.

### Can the agent pay for me?

No; the site says payment returns to you to confirm.

### Which cities?

Shenzhen, Guangzhou, Shanghai, Beijing, Hong Kong, Macau, Singapore and more.

### Is CUQU找搭子 (CUQU) MCP Server free?

Yes. CUQU找搭子 (CUQU) MCP Server is free to use.

### How do I add CUQU找搭子 (CUQU) MCP Server to Claude Code?

Run this command in your terminal: claude mcp add --transport http cuqu-mcp https://agent.cuqu.net/mcp

### What are the best alternatives to CUQU找搭子 (CUQU) MCP Server?

The closest alternatives to CUQU找搭子 (CUQU) MCP Server are MaineMCP, Agent Bookability Index, Tap2Cal, Veseljko katalog usluga za proslave and 숏츠생성기 Free K-pop Shorts.

## Alternatives

- [MaineMCP](https://ai-powered.com/mcp/mainemcp): MaineMCP is a free MCP server for events and entertainment.
- [Agent Bookability Index](https://ai-powered.com/mcp/agent-bookability-index): Agent Bookability Index is a free MCP server for events and entertainment.
- [Tap2Cal](https://ai-powered.com/mcp/tap2cal): Tap2Cal is a free MCP server for productivity.
- [Veseljko katalog usluga za proslave](https://ai-powered.com/mcp/veseljko-katalog-usluga-za-proslave): Veseljko katalog usluga za proslave is a free MCP server for events and entertainment.
- [숏츠생성기 Free K-pop Shorts](https://ai-powered.com/mcp/free-k-pop-shorts): 숏츠생성기 Free K-pop Shorts is a free MCP server for design and media.
- [Tickets: tours and event tickets in South America](https://ai-powered.com/mcp/tickets-tours-and-event-tickets-in-south-america): Tickets: tours and event tickets in South America is a free MCP server for maps and travel.
- [DalVivo](https://ai-powered.com/mcp/dalvivo): DalVivo is a free MCP server for maps and travel.
- [Last.fm MCP](https://ai-powered.com/mcp/last-fm-mcp): Last.fm MCP is an open-source MCP server for events and entertainment.

---
Source: https://ai-powered.com/mcp/cuqu-cuqu-mcp-server
