Run, join or judge a hackathon on the website or in your AI app.

Simple Hack works the same both ways. Pick whichever you like for each step below, and switch any time.

Connect your AI app

Paste this address into Claude, ChatGPT, Claude Code, or any other AI app that takes a custom MCP connector URL.

https://simple-hack.app/mcp

Steps for Claude, ChatGPT and Claude Code are under Pick your AI below.

Organiser

Create the event, open sign-up, and share the join and judge links.

On the website

  1. Sign in at simple-hack.app with Google or an email code.
  2. On Home, click Create event, fill in the details, then click Create event again to save it as a draft.
  3. From the sidebar, open Judging to write your rubric, and Teams, then its Tracks tab, to add tracks if you want them.
  4. On Overview, click your next step when you're ready. It walks you from opening sign-up through to publishing results.
  5. Under Share your event, click Copy next to your join link and judge link, and send them out.

In your AI app

Add Simple Hack to your AI once (see Pick your AI below), then ask in a new chat:

Create a hackathon called Night Build for next Saturday and Sunday, and give me the join link.

Your AI may ask for event details or confirmation before opening an event.

Participant

Join the event, find a team, and publish your team's site.

On the website

  1. Open the join link the organiser sent you, then sign in with Google or an email code.
  2. Fill in your name, answer any questions, check I agree to the code of conduct, then click Join event (or Send application, if the event needs approval).
  3. On Team, choose how you want to team up: Start a new team, Ask to join a team, or Join with a link or code.
  4. On Entry, fill in your project's details and click Save draft.
  5. On Website, click Upload to publish a zip of your site yourself. No AI app needed.
  6. Back on Entry, click Submit entry. Some events need a website first.

In your AI app

Add Simple Hack to your AI once (see Pick your AI below), then describe your idea:

Join the hackathon with code ab12cd34 and start a team called Night Owls. Build our team’s site: an app that matches volunteers to shifts.

Use your event’s real join code. Your AI builds the page and publishes it to your team's Website tab.

Judge

Accept the judge invite, then score your assigned teams.

On the website

  1. Open the judge link the organiser sent you, then sign in with Google or an email code.
  2. Read the code of conduct, type your name, check I agree to the code of conduct, then click Join as judge.
  3. Read the brief under Rubric & brief.
  4. Open My teams and click Score this team.
  5. Tap a score for each part of the rubric, add an optional comment, then click Save & next (Save & finish on your last team).

In your AI app

Add Simple Hack to your AI once (see Pick your AI below), then ask in a new chat:

I’m judging Night Build. Show me my next entry.

You’ll need the organiser’s judge link first, the same as on the website.

Pick your AI

One-time setup. Add Simple Hack to the AI app you use, with the address above, then use the prompts above from any role.

ChatGPTOn the web

Add custom MCP server

The fastest way: one address to paste.

  1. Open ChatGPT Plugins.
  2. Click Add, then choose Add custom MCP server.
  3. Name it Simple Hack, paste this address, and save.
    https://simple-hack.app/mcp
  4. A sign-in window opens. Sign in with Google or an email code, then choose Allow.

ChatGPT keeps the tool list from the day you added Simple Hack. When Simple Hack adds features, open ChatGPT Plugins, choose Simple Hack, then Refresh.

Or add it by its address, in developer mode:

  1. Open Settings, then Apps & Connectors, then Advanced settings, and turn on Developer mode.
  2. Back in Apps & Connectors, choose Create.
  3. Name it Simple Hack, and paste this address as the MCP server URL:
    https://simple-hack.app/mcp
  4. Choose OAuth for authentication, then Create.
  5. Sign in with Google or an email code, then choose Allow.

Upload plugin archive

Also installs the five skills, so your AI follows Simple Hack's own instructions. This ZIP includes the MCP connection.

  1. Download the ChatGPT plugin ZIP.
  2. Open ChatGPT Plugins.
  3. Click Add, then choose Upload plugin archive, and choose the ZIP file.
  4. When the sign-in window opens, sign in with Google or an email code, then choose Allow.

In a chat, pick Simple Hack from the + menu, or just ask.

Simple Hack is in review in the ChatGPT app directory. Once it is approved, you will be able to add it from there.

ClaudeWeb, desktop, and phone
  1. Open Claude, then Settings, then Connectors, then Browse connectors.
  2. Search for Simple Hack, choose Connect, sign in, then choose Allow.

Works on web, desktop, and phone.

Claude setup guide

On a network that blocks the directory, add it as a custom connector instead: name it Simple Hack, paste this address:

https://simple-hack.app/mcp

Or add it by its address:

  1. Open Claude, then Settings, then Connectors, then Add custom connector.
  2. Name it Simple Hack, paste this address, and choose Add:
    https://simple-hack.app/mcp
  3. Choose Connect, sign in, then choose Allow.
Claude CodeTerminal
  1. Run this in your terminal:
    claude mcp add --transport http simple-hack https://simple-hack.app/mcp
  2. In Claude Code, type /mcp, choose simple-hack, then Authenticate.
  3. Sign in with Google or an email code, then choose Allow.
Other AI apps

They connect the same way, with the same address.

GrokCustom connectors
  1. Open grok.com/connectors, then New Connector → Custom.
  2. Name it Simple Hack, paste this address into Server URL, and click Add Connector:
    https://simple-hack.app/mcp
  3. Sign in once in the Simple Hack window that opens, with Google or an email code, then choose Allow.
Grok setup guide
GitHub CopilotVS Code
  1. Open the Command Palette, run MCP: Add Server and choose HTTP.
  2. Paste this address, name it simple-hack, save and start the server. Accept the trust prompt.
    https://simple-hack.app/mcp
  3. Sign in once in the Simple Hack window that opens, with Google or an email code, then choose Allow. Use Copilot Chat’s agent mode.
VS Code setup guide
Meta MuseCustom connector
  1. In Muse, open Settings, then Connectors, then Add custom connector.
  2. Paste this address as the MCP URL:
    https://simple-hack.app/mcp
  3. Muse asks for a Client ID. Type this, not your email:
    meta-muse
  4. Sign in once in the Simple Hack window that opens, with Google or an email code, then choose Allow.
GeminiPersonal Google account, in the US
  1. On a computer, open gemini.google.com, then Settings, then Connected Apps.
  2. Under Custom apps, choose Add a custom app, paste this address, and choose Next:
    https://simple-hack.app/mcp
  3. Sign in once in the Simple Hack window that opens, with Google or an email code, then choose Allow.

Google offers custom apps to people 18 and over in the US, signed in with a personal account, with Keep Activity on.

Mistral VibeFormerly Le Chat. Free plan works
  1. Open Connectors, choose Add Connector, then the Custom MCP Connector tab.
  2. Name it simplehack, paste this address as the Server URL, and choose Connect:
    https://simple-hack.app/mcp
  3. Sign in once in the Simple Hack window that opens, with Google or an email code, then choose Allow.
LovableApp builder
  1. In Lovable, open Connectors, choose Add custom, then MCP server.
  2. Name it Simple Hack, leave Connection on Direct connection, and paste this address as the Server URL:
    https://simple-hack.app/mcp
  3. Keep OAuth, choose Add & authorize, sign in once in the Simple Hack window that opens, then choose Allow.
BoltApp builder
  1. In Bolt, click + in the chat box, then Connectors, then Manage connectors, then Custom MCP server.
  2. Name it Simple Hack, paste this address as the URL, and keep the HTTP transport:
    https://simple-hack.app/mcp
  3. Under Authentication, choose MCP OAuth, then Connect. Sign in once in the Simple Hack window that opens, then choose Allow.
  4. In your project, click +, then Connectors, and turn on Simple Hack.
CursorCode editor
  1. Add this to ~/.cursor/mcp.json (or .cursor/mcp.json in your project):
    {"mcpServers":{"simple-hack":{"url":"https://simple-hack.app/mcp"}}}
  2. When Cursor asks, sign in once in the Simple Hack window that opens, with Google or an email code, then choose Allow.
Any other AI appCodex, Replit, v0, Windsurf and others
  1. Add this address as a custom MCP connector (sometimes called an MCP server) in your app's settings, for example in Codex, Replit, v0 or Windsurf. If it asks how to sign in, choose OAuth:
    https://simple-hack.app/mcp
  2. Sign in once in the Simple Hack window that opens, with Google or an email code, then choose Allow.

After connecting, select Simple Hack in your chat’s tools, then use one of the prompts above.

What happens next

Manage your event, team or judging from simple-hack.app on any device, or from your AI app once it's connected. Your AI gives you the links to share.

Is it free?
Yes. Running an event, joining, judging and hosting team sites are free.
Who sees the scores?
After results are published, ranks and overall scores are public by default. Organisers can hide either. Teams privately see their own detailed scores and feedback; organisers see all results.
Do I need a laptop?
No. You can run, join or judge from a phone. Coding agents need a computer.
Where do team sites live?
At team.event.simple-hack.app, using your team and event names.
Can I run my own?
Other ways to install

Optional: Simple Hack's skill files for coding agents. They add instructions, not the connection — connect https://simple-hack.app/mcp as above first.

  1. Install the five Simple Hack skills for Claude Code, Codex and other coding agents, then restart your agent:
    npx -y skills add https://github.com/vineetu/simple-host/tree/main/hack-toolkit --global --agent codex claude-code --yes
    For another agent, replace codex claude-code with its name, such as openclaw or hermes-agent.

Or download the skill folders directly, or upload the skills-only plugin ZIP in a ChatGPT workspace that supports custom plugin uploads.