MCP Apps Hackathon @ YC by Manufact

A hackathon starter built with mcp-use and deployed on Manufact Cloud. Part of the MCP Apps Hackathon by Manufact at Y Combinator.

Getting Started

Install dependencies and start the dev server:

npm install
npm run dev

Open http://localhost:3000/inspector to test your server interactively — no external tunneling needed.

You can start building by editing index.ts. Add tools, resources, and prompts — the server auto-reloads as you edit thanks to Hot Module Reloading (HMR).

Connecting to Claude or ChatGPT

Local testing with tunnel

Start the dev server with a built-in tunnel to get a public HTTPS URL instantly — no deployment needed:

npm run dev -- --tunnel

The CLI prints a stable public URL like https://<subdomain>.tunnel.mcp-use.com/mcp. Add it as a remote MCP server:

• Claude: Settings → Integrations → Add integration → paste the tunnel URL
• ChatGPT: Settings → Connectors → Add MCP server → paste the tunnel URL

The tunnel keeps the same subdomain across restarts, so your link stays stable while you iterate.

After deployment

Once deployed to Manufact Cloud, add your production URL as a remote MCP server:

https://<your-slug>.run.mcp-use.com/mcp

Alternative: Goose (no Claude Pro or ChatGPT Plus required)

If you don't have a Claude Pro or ChatGPT Plus account, you can use Goose

Follow the Goose quickstart to install it, then add your tunnel or deployed URL as an MCP extension.

Deploy

Manufact Cloud Dashboard

1. Sign in at manufact.com
2. Go to Servers → New Server
3. Connect your GitHub repository
4. Click Deploy

Your server will be live at https://<your-slug>.run.mcp-use.com/mcp and manageable from the dashboard.

CLI

# Login to Manufact Cloud
npx @mcp-use/cli login

# Deploy from your repo root
npm run deploy

The CLI detects your GitHub repository, builds the project, and streams logs until deployment completes:

✓ Deployment successful!

🌐 MCP Server URL:
   https://<your-slug>.run.mcp-use.com/mcp

📊 Dashboard:
   https://manufact.com/cloud/servers/<your-slug>

Subsequent npm run deploy calls redeploy to the same URL

Resources

• mcp-use Documentation — guides, API reference, and tutorials
• CLI Reference — full mcp-use CLI docs
• Manufact Cloud Deployment — deployment guide
• MCP Apps / UI Widgets — build interactive widgets in Claude and ChatGPT
• Model Context Protocol — the open standard powering MCP servers
• Goose — free open-source MCP client
• MCP Apps Hackathon — event page