Run, join or judge a hackathon from the AI you already use.

Add Simple Hack to your AI once. Then just ask.

Pick your AI

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.

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
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.
Claude Code / Codex / other coding agentsTerminal, Node.js
  1. Install the five Simple Hack skills for Claude Code and Codex, 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.
  2. Ask your agent to add Simple Hack as a remote HTTP MCP server with OAuth at this address:
    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.

After connecting, select Simple Hack in your chat’s tools and try a prompt below. Your AI may ask for event details or confirmation before opening an event.

Try one of these

Organiser

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

Participant

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.

Judge

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

No coding needed. Describe your idea to your AI and it builds your team's site.

Use your event’s real join code. Judges need the organiser’s judge link first.

What happens next

Your AI helps with the event and gives you the links to share. You can also manage your event, team or judging from Simple Hack on your phone.

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?
Yes. Self-host a hackathon with Simple Host.
Other ways to install

Download the five skill folders for your coding agent, or upload the skills-only plugin ZIP in a ChatGPT workspace that supports custom plugin uploads. Connect https://simple-hack.app/mcp as above to use them.

Skills ZIPSkills-only ChatGPT plugin ZIPAlternate skills ZIP