Lets an AI client search and rank live AI and Web3 hackathons, grants, and bounties based on skills, location, and prize type.
Also known as mrfomoweb3/hacklist-mcp, hacklist-mcp
- Stars
- 0
- Tools
- 8
- Downloads, 30 days
- —
- Latest version
- 0.2.0
- Last commit
- Oct 23, 2026
- License
- MIT
What is HackList MCP?
HackList lets an AI client search and rank live AI and Web3 hackathons, grants, and bounties based on skills, location, and prize type. It exposes 8 tools, such as search_opportunities, get_opportunity, best_opportunities.
Summary generated from the project's README
About HackList MCP server
HackList provides developers and builders with a way to discover and filter AI and Web3 hackathons, grants, and bounties through an AI client. Instead of browsing a raw list, users can use this server to find specific opportunities that match their technical skills, geographic location, and prize preferences. It is designed to work with Claude and ChatGPT, either by connecting to a hosted remote URL or running locally via stdio using Node.js.
The server improves data quality by performing several automated tasks. It converts various currencies into approximate USD values, separates cash prizes from cloud credits, and identifies duplicate listings. It also filters out events that are ineligible due to region locks, student-only requirements, or in-person constraints. Developers can use tools like best_opportunities to receive ranked recommendations that explain why a specific event was chosen and what risks to watch out for.
What you can do with it
- 1Find personalized opportunitiesAsk the AI to find hackathons that match your specific programming languages and location constraints.
- 2Filter for cash prizesRequest a list of upcoming events that offer actual cash rather than just service credits.
- 3Identify urgent deadlinesSearch for specific technical tracks that are closing within a certain number of days.
- 4Analyze brief qualityDetermine if a hackathon prompt is specific or too generic to be useful.
Written from the project's README. Every use case is checked against a quote from it.
How to install HackList MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall HackList MCP in Claude Code
$ claude mcp add hacklist-mcp -- npx -y hacklist-mcpInstall HackList MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"hacklist-mcp": {
"command": "npx",
"args": [
"-y",
"hacklist-mcp"
]
}
}
}Install HackList MCP in VS Code
.vscode/mcp.json
{
"servers": {
"hacklist-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"hacklist-mcp"
]
}
}
}Install HackList MCP in VS Code CLI
$ code --add-mcp '{"name":"hacklist-mcp","type":"stdio","command":"npx","args":["-y","hacklist-mcp"]}'Install HackList MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"hacklist-mcp": {
"command": "npx",
"args": [
"-y",
"hacklist-mcp"
]
}
}
}Install HackList MCP in Codex
$ codex mcp add hacklist-mcp -- npx -y hacklist-mcpInstall HackList MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.hacklist-mcp] command = "npx" args = ["-y", "hacklist-mcp"]
Install HackList MCP in Gemini CLI
$ gemini mcp add -s user hacklist-mcp npx -- -y hacklist-mcpInstall HackList MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"hacklist-mcp": {
"command": "npx",
"args": [
"-y",
"hacklist-mcp"
]
}
}
}Started by HostedMCP on 16 Nov 2026
We ran this command for hacklist-mcp 0.2.0 in an isolated container with no network and no keys. It answered and listed 8 tools.
HackList MCP tools 8
Read from the server with tools/listsearch_opportunitiesRead-onlySearch 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.
get_opportunityRead-onlyFull 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.
best_opportunitiesRead-onlyRanks 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.
whats_newRead-onlyListings 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.
closing_soonRead-onlyOpen listings whose deadline is within N days, soonest first, with the prize and whether it's worth a sprint.
hacklist_overviewRead-onlyA 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.
searchRead-onlySearch open HackList hackathons, grants and programs by keyword. Returns ids to pass to fetch. (Compatibility tool for ChatGPT connectors and deep research.)
fetchRead-onlyFetch the full HackList listing for an id returned by search. (Compatibility tool for ChatGPT connectors and deep research.)
Automated checks
Ran Nov 13, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablemrfomoweb3/hacklist-mcp is public and reachablegithub.com/mrfomoweb3/hacklist-mcp ↗Pass
- Package names this repository as its sourcehacklist-mcp names mrfomoweb3/hacklist-mcp as sourcenpmjs.com/package/hacklist-mcp ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-23github.com/mrfomoweb3/hacklist-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from hacklist-mcpPass
- No critical advisory in the package or its dependencies122 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model6 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 186 msPass
README
View on GitHubhacklist-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 list | What 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 credits | Separates cash from credits clause by clause; headline shows the cash |
| ₹, USDC, USDT, € prizes you can't compare | Converts to an approximate USD figure (original text always kept) |
| Events you can't actually enter | Flags 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 deadline | Kept 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
| Tool | What it does |
|---|---|
best_opportunities |
Ranks open opportunities for a builder (skills, interests, country, student, can travel, cash only). Down-ranks generic briefs, removes ineligible ones, explains each pick. |
search_opportunities |
Keyword 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_opportunity |
Full 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_new |
Listings posted or updated in the last N days. |
closing_soon |
Open listings ending within N days, soonest first. |
hacklist_overview |
Counts, cash prize total, biggest prizes, duplicate groups, data coverage. refresh: true re-fetches. |
search / fetch |
The 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)
- Open Settings → Connectors and click Add custom connector.
- Name:
HackList. Remote MCP server URL: the URL above. Click Add. - In a chat, open the tools menu next to the message box and make sure HackList is turned on.
- Ask: "What hackathons are open right now?" or "What should I enter this month? I write Solidity and I'm in Nigeria."
ChatGPT
- Open Settings → Apps & Connectors → Advanced settings and turn on Developer mode.
- Back in Apps & Connectors, click Create.
- Name:
HackList. MCP server URL: the URL above. Authentication: No authentication. Tick the box saying you trust this application, then click Create. - 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:
{
"mcpServers": {
"hacklist": {
"command": "npx",
"args": ["-y", "hacklist-mcp"]
}
}
}
Claude Code
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
npm install && npm run build
PORT=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:
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:
npx wrangler login
npm run dev:worker # local, http://localhost:8787/mcp
npm run deploy:worker # https://hacklist-mcp.<your-subdomain>.workers.dev/mcp
npx 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
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 var | Default | Purpose |
|---|---|---|
PORT |
3000 |
HTTP mode port |
HACKLIST_MCP_TOKEN |
unset | Require a bearer token in HTTP mode |
HACKLIST_LIST_TTL_MS |
1200000 (20 min) |
How long a snapshot stays fresh |
HACKLIST_MAX_DETAIL_FETCHES |
260 |
Cap on detail pages fetched per refresh |
HACKLIST_CACHE_DIR |
~/.cache/hacklist-mcp |
Disk cache for detail pages (restarts are instant) |
HACKLIST_BASE_URL |
https://hacklist.io |
Override for testing or a mirror |
HACKLIST_FEED_URL |
/api/opportunities |
Feed path or full URL |
How it gets the data
- 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 realcreated_atposting date. - 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. - 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
npm install
npm test # 19 tests: feed + page parsers, fallback, prize/eligibility/duplicate logic, full MCP round-trips
npm 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: trueturns the penalty off.
MIT licensed.
HackList MCP questions
How do I add HackList MCP to Claude Code?
Run claude mcp add hacklist-mcp -- npx -y hacklist-mcp in your terminal. Add --scope user to make it available in every project.
How do I add HackList MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does HackList MCP provide?
It exposes 8 tools, including search_opportunities, get_opportunity, best_opportunities, whats_new, closing_soon.
Can I filter hackathons by my specific constraints?
Yes, the best_opportunities tool ranks opportunities based on your skills, interests, country, student status, and travel ability.
Does the server provide information on eligibility?
Yes, it flags events that are student-only, region-locked, in-person-only, or application-gated to help you find suitable entries.
Is there a way to find upcoming deadlines?
Yes, you can use the closing_soon tool to find open listings ending within a specific number of days.