HackList

io.github.mrfomoweb3Published by GitHub account mrfomoweb3v0.2.0Updated Oct 27, 2026

Live AI & Web3 hackathons, grants and programs from HackList, ranked for what's worth entering.

VerifiedStreamable HTTPWeb executableProductivity & WorkflowWeb Search & Scraping

Overview

AI-generated overview

Gives an assistant live HackList data on AI and Web3 hackathons, grants, bounties and programs, with search, detail lookup and skill-based ranking.

What you can do
  • Search and filter open hackathons, grants, bounties and programs by keyword, type, category, format, prize, deadline and recency
  • Read one listing in full: brief, prize with USD estimate and cash versus credits, deadline, apply link, eligibility limits and duplicates
  • Rank open opportunities against a builder's skills and constraints, with a reason and watch-outs for each pick
  • List what was posted or updated in the last N days, and what closes within N days
  • Summarize the directory: counts by type and category, total prize money, biggest prizes and data freshness
  • Compatibility search and fetch tools for ChatGPT connectors and deep research
When to use it
Useful when someone wants to find hackathons, grants or bounties to enter, decide which ones are worth the time, or check a specific listing's prize, deadline and eligibility. Also handy for weekly "what's new" or "closing soon" checks.
Requirements
Either the hosted remote endpoint (no install, no authentication) or a local process via npx, which needs Node 18.17 or later. Self-hosting the HTTP or Cloudflare Worker mode optionally uses HACKLIST_MCP_TOKEN to require a bearer token; other settings cover port, cache and feed URLs. Network access to HackList is needed.
Before you install
All tools are read-only and no credentials are required for the hosted endpoint. Prize USD figures are estimates from fixed FX rates, crypto prizes get no estimate, and generic-brief scoring is heuristic, so results should be checked against the original listing text. The project is not affiliated with HackList and depends on its feed, falling back to page scraping that may miss some programs, grants and bounties.

Installation

In SourceWeft

  1. Open HackList in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.mrfomoweb3%2Fhacklist-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "hacklist": {
      "type": "http",
      "url": "https://hacklist-mcp.samuelsuccess234.workers.dev/mcp"
    }
  }
}

README

hacklist-mcp

An MCP server that gives Claude and ChatGPT live access to HackList, the directory of AI and Web3 hackathons, grants, bounties and programs.

Ask things like:

  • "What should I enter this month? I write Solidity and Python, build agents, I'm in Nigeria and can't travel."
  • "When was the Qloo hackathon posted, and what's the actual cash prize?"
  • "Anything new on HackList this week over $10k?"
  • "Find ZK or privacy hackathons closing in the next 10 days."

Why it isn't just a scraper

HackList lists everything. This server tells you which listings are worth your weekend:

Problem on the raw listWhat the server does
Same event listed twice (Amazon, GitLab, OpenCV, GenAI Works…)Detects duplicates by title, organizer, deadline and apply link, and collapses them
"$190,000 total value" that is mostly AWS creditsSeparates cash from credits clause by clause; headline shows the cash
₹, USDC, USDT, € prizes you can't compareConverts to an approximate USD figure (original text always kept)
Events you can't actually enterFlags students-only, region-locked, in-person-only, partners-only and application-gated events, and drops them from recommendations
"Build an AI app that solves real-world problems"Scores each brief for how generic it is (0 = specific, 1 = generic) and lists the concrete hooks: named APIs, datasets, scoring metrics, tracks
Rolling grants and bounties with no deadlineKept as open ("no fixed deadline") and ranked fairly instead of being dropped or buried

best_opportunities combines all of that with your skills and constraints and explains every pick (why) and every risk (watch_outs).

Tools

ToolWhat it does
best_opportunitiesRanks open opportunities for a builder (skills, interests, country, student, can travel, cash only). Down-ranks generic briefs, removes ineligible ones, explains each pick.
search_opportunitiesKeyword search with filters: type, AI/Web3, online/in-person/hybrid, min prize, cash only, closes within N days, updated within N days, include closed.
get_opportunityFull detail for one listing by HackList URL, id or title: brief, prize (USD estimate, cash vs credits), deadline and days left, posted/updated date, apply link, eligibility, duplicates.
whats_newListings posted or updated in the last N days.
closing_soonOpen listings ending within N days, soonest first.
hacklist_overviewCounts, cash prize total, biggest prizes, duplicate groups, data coverage. refresh: true re-fetches.
search / fetchThe two tools ChatGPT connectors and deep research expect.

All tools are read-only.

Install

Claude and ChatGPT on the web (no install)

A hosted server is live, so on claude.ai and chatgpt.com you only paste one URL:

https://hacklist-mcp.samuelsuccess234.workers.dev/mcp

claude.ai (also syncs to the Claude desktop and mobile apps)

  1. Open Settings → Connectors and click Add custom connector.
  2. Name: HackList. Remote MCP server URL: the URL above. Click Add.
  3. In a chat, open the tools menu next to the message box and make sure HackList is turned on.
  4. Ask: "What hackathons are open right now?" or "What should I enter this month? I write Solidity and I'm in Nigeria."

ChatGPT

  1. Open Settings → Apps & Connectors → Advanced settings and turn on Developer mode.
  2. Back in Apps & Connectors, click Create.
  3. Name: HackList. MCP server URL: the URL above. Authentication: No authentication. Tick the box saying you trust this application, then click Create.
  4. In a chat, click +, choose Developer mode, enable HackList, and ask your question.

ChatGPT's deep research uses the search and fetch tools; normal chats can call all of them.

If you can't find the connector option, check your plan: Claude and ChatGPT decide which plans can add custom connectors, and that changes over time.

Claude Desktop (local, stdio)

Requires Node 18.17+.

Add to claude_desktop_config.json:

json
{  "mcpServers": {    "hacklist": {      "command": "npx",      "args": ["-y", "hacklist-mcp"]    }  }}

Claude Code

bash
claude mcp add --transport http hacklist https://hacklist-mcp.samuelsuccess234.workers.dev/mcp# or run it locally:claude mcp add hacklist -- npx -y hacklist-mcp

Cursor, Windsurf, other stdio clients

Same command: npx -y hacklist-mcp.

Self-hosting the connector

To run your own copy instead of the hosted URL, deploy the HTTP mode or the Cloudflare Worker (below) and use https://your-host/mcp in the steps above.

Run the HTTP server

bash
npm install && npm run buildPORT=3000 npm run start:http          # serves POST /mcp and GET /healthz

Stateless Streamable HTTP, so it scales horizontally and works behind any load balancer. One HackList snapshot is shared across requests.

Deploy anywhere that runs Docker:

bash
docker build -t hacklist-mcp .docker run -p 3000:3000 hacklist-mcp

Works as-is on Render, Railway, Fly.io or Cloud Run (all give you HTTPS). To keep it private, set HACKLIST_MCP_TOKEN and the server will require Authorization: Bearer <token>. Leave it unset for a public, no-auth connector.

Cloudflare Workers

src/worker.ts serves the same endpoints without Express or a disk cache:

bash
npx wrangler loginnpm run dev:worker                    # local, http://localhost:8787/mcpnpm run deploy:worker                 # https://hacklist-mcp.<your-subdomain>.workers.dev/mcpnpx wrangler secret put HACKLIST_MCP_TOKEN   # optional, same bearer-token behaviour

The HackList snapshot is cached per Worker instance, so a cold instance's first call re-fetches the feed (about 2s). If the free plan's 10ms CPU limit trips on cold starts (Exceeded CPU Limit in npx wrangler tail), move to Workers Paid.

Check it's reading HackList correctly

bash
npm run check

Prints whether the official feed was used, how many listings were loaded vs. what HackList says is open, and how often each field was filled.

Configuration

Env varDefaultPurpose
PORT3000HTTP mode port
HACKLIST_MCP_TOKENunsetRequire a bearer token in HTTP mode
HACKLIST_LIST_TTL_MS1200000 (20 min)How long a snapshot stays fresh
HACKLIST_MAX_DETAIL_FETCHES260Cap on detail pages fetched per refresh
HACKLIST_CACHE_DIR~/.cache/hacklist-mcpDisk cache for detail pages (restarts are instant)
HACKLIST_BASE_URLhttps://hacklist.ioOverride for testing or a mirror
HACKLIST_FEED_URL/api/opportunitiesFeed path or full URL

How it gets the data

  1. Official feed (GET https://hacklist.io/api/opportunities), provided by HackList. One request per refresh (cached 20 min) returns every open hackathon, program, grant and bounty, with each listing's real created_at posting date.
  2. Fallback: if the feed is down or returns something unexpected, the server reads the public pages instead (homepage, /sitemap.xml, detail pages), keyed off visible labels so cosmetic redesigns don't break it.
  3. Closed listings (include_closed: true) come from the sitemap and detail pages, since the feed only lists open ones.

hacklist_overview and every result report data_source (feed or pages) and data_as_of (when HackList generated the feed).

Thanks to HackList (@0xbeni, Telegram) for exposing the feed. This project is not affiliated with HackList.

Develop

bash
npm installnpm test        # 19 tests: feed + page parsers, fallback, prize/eligibility/duplicate logic, full MCP round-tripsnpm run dev     # stdio server via tsx

Limits

  • Prize USD figures are estimates (fixed approximate FX rates). The original prize text is always returned alongside.
  • Prizes paid in crypto (ETH, SOL…) get no USD estimate because the price moves; they're labeled instead.
  • In page-scraping fallback mode, programs, grants and bounties beyond the homepage's first page may be missing (the sitemap only covers hackathons).
  • "Generic" scoring is heuristic. It's tuned to separate briefs like "build any AI app" from briefs like "detect 12 knee MRI abnormalities, scored by AUC", and include_generic: true turns the penalty off.

MIT licensed.

Source: README.md at commit 4fa6e14

Tools

8

search_opportunities

Search HackList

Search and filter HackList's AI & Web3 hackathons, grants, bounties and programs. Filters by keyword, type, category, format, prize, how soon it closes and how recently it was posted or updated. Duplicate listings of the same event are collapsed by default. Use get_opportunity for the full brief and eligibility details of a result.

Parameterskindsortlimitqueryformatcategorycash_onlyfree_onlymin_prize_usdinclude_closedcloses_within_dayscollapse_duplicates+1 more

get_opportunity

Get HackList listing

Full details for one HackList listing: brief, prize (with USD estimate and cash vs credits), deadline and days left, when it was posted/updated on HackList, apply link, eligibility traps (students only, region-locked, in-person, approval needed) and duplicate listings. Accepts a HackList URL, an id, or a title.

Parametersrefrequired

best_opportunities

Rank the best non-generic opportunities

Ranks open HackList opportunities for a specific builder and explains each pick. Favours specific briefs (a named API, dataset, metric or protocol) over generic 'build anything with AI' events, weighs prize size and whether it is real cash, deadline runway and accessibility, collapses duplicate listings, and drops events the builder can't enter (students only, region-locked, in-person, partners only). Returns why each one ranks and what to watch out for.

Parameterskindlimitskillscountrycash_onlyinterestscan_travelis_studentmax_days_leftmin_days_leftinclude_generic

whats_new

New on HackList

Listings posted or updated on HackList in the last N days, newest first. Useful for 'what got added this week'. Uses HackList's own posted date when the site exposes it, otherwise its sitemap last-modified time.

Parametersdayslimitopen_only

closing_soon

Closing soon on HackList

Open listings whose deadline is within N days, soonest first, with the prize and whether it's worth a sprint.

Parametersdayslimitmin_prize_usd

hacklist_overview

HackList overview

A snapshot of HackList right now: how many open listings by type and category, total listed prize money, the biggest prizes, duplicate listings found, and how fresh/complete this server's data is. Pass refresh=true to re-fetch.

Parametersrefresh

fetch

Fetch HackList listing (connector)

Fetch the full HackList listing for an id returned by search. (Compatibility tool for ChatGPT connectors and deep research.)

Parametersidrequired

Version history

1
  1. v0.2.0LatestOct 21, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts