# 黑123 Hackathons

> 黑123 Hackathons is a free MCP server for events and entertainment. Read-only search of hackathons, team-up posts and projects on the Chinese site hack123. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** Web, API
- **Website:** https://hack123.henryht.sh/about
- **Repository:** https://github.com/henryagentteam/hack123
- **MCP Registry name:** io.github.onehumanbeing/hack123
- **Categories:** events and entertainment, community directories
- **Listing updated:** 2026-11-15

## About

The site behind this server, 黑123 (hack123), collects every past issue of a weekly newsletter on beginner-friendly hackathons in China and abroad, covering AI, student and online events. Each hackathon page keeps the newsletter's original text and a sign-up link, and the site notes that eligibility, dates and prizes should be checked against the organiser's own announcement.

The filtering is unusually well defined. Audience tags separate students, young people, women and working developers. Difficulty runs from beginner-friendly (zero experience stated) to hardcore (production-grade or enterprise briefs). Prize filters include a 100,000 RMB-plus cash threshold, and unstated tags are left blank rather than guessed. Results come in Chinese and English with links back to the site.

The remote server needs no login. The same site's about page also sells one-on-one hackathon coaching at 899 RMB per hour, which is separate from the MCP server.

## Features

- **Hackathon search:** Filter by keyword, city, online, theme, date and status.
- **Hackathon details:** Fetch one event by its slug.
- **Team-up posts:** Search posts from people looking for teammates.
- **Project search:** Find submitted works by hackathon or tag.
- **Bilingual results:** Output is in Chinese and English with site links.
- **No login:** Remote Streamable HTTP server, read-only.

## Good for

- Finding a beginner-friendly hackathon in China
- Looking for teammates for an upcoming event
- Browsing past projects from a particular hackathon
- Filtering events by prize size or theme

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http hack123 https://hack123.henryht.sh/api/mcp
```

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

```sh
https://hack123.henryht.sh/api/mcp
```

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

```json
{
  "mcpServers": {
    "hack123": {
      "url": "https://hack123.henryht.sh/api/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "hack123": {
      "type": "http",
      "url": "https://hack123.henryht.sh/api/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "hack123": {
      "serverUrl": "https://hack123.henryht.sh/api/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "hack123": {
      "type": "http",
      "url": "https://hack123.henryht.sh/api/mcp"
    }
  }
}
```

## Tools

- `search_hackathons`: Search hackathons by keyword, city, online, theme, date and status.
- `get_hackathon`: Get hackathon details by slug.
- `search_team_posts`: Find team-up posts.
- `search_works`: Search projects by hackathon or tag.

## FAQ

### Do I need an account?

No. The remote MCP server is read-only and needs no login.

### What languages does it return?

Results are bilingual, Chinese and English.

### Where do the details come from?

Each hackathon keeps the original newsletter text; the site says to confirm eligibility, dates and prizes with the organiser.

### What is the endpoint?

https://hack123.henryht.sh/api/mcp over Streamable HTTP.

### Is 黑123 Hackathons free?

Yes. 黑123 Hackathons is free to use.

### How do I add 黑123 Hackathons to Claude Code?

Run this command in your terminal: claude mcp add --transport http hack123 https://hack123.henryht.sh/api/mcp

### What are the best alternatives to 黑123 Hackathons?

The closest alternatives to 黑123 Hackathons are BoardAgent, KitScout, MaineMCP, Agent Bookability Index and Tap2Cal.

## Alternatives

- [BoardAgent](https://ai-powered.com/mcp/boardagent): BoardAgent is a free MCP server for community directories.
- [KitScout](https://ai-powered.com/mcp/kitscout): KitScout is a free MCP server for developer tools.
- [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.

---
Source: https://ai-powered.com/mcp/123-hackathons
