HireMe MCP

HireMe MCP

The first portfolio AI agents can hire. An open Model Context Protocol server that exposes Djaouad Frih's real profile, shipped products, fixed pricing and a project-brief intake — so Claude, Cursor, ChatGPT or any MCP client can vet the work and file a brief on your behalf.

Live: https://mcp.djaouad.tech · MCP endpoint: https://mcp.djaouad.tech/mcp

Tools

Tool	Type	What it does
get_profile	read	Identity, stack, live products, availability, contact links
search_projects	read	Semantic-ish search over shipped projects (proof of experience)
get_pricing	read	Fixed-price services in USD with ETAs
get_next_slot	read	Availability status + direct booking link
submit_project_brief	write	Files a project brief → persisted + emailed. Rate limited per IP

The famous flows

1. Founder delegate — "Claude, find me an AI engineer under $2k and send them my requirements" → their agent calls get_pricing → search_projects → files a brief.
2. Recruiter deep-dive — "Has he actually shipped RAG?" → grounded answers with demo links.
3. Comparison shopper — pricing + timeline vs. an agency, plus next opening.

Structure

backend/    Express + @modelcontextprotocol/sdk (Streamable HTTP, stateless)
            POST /mcp            ← MCP clients
            /api/tools/:id       ← same handlers over REST (widget, mobile)
            /api/briefs          ← admin inbox (Bearer ADMIN_TOKEN)
            /widget.js           ← embeddable badge
frontend/   Next.js console (Netlify → mcp.djaouad.tech): connect configs,
            live playground, scenarios
mobile/     Expo app: profile, tool runner, admin briefs inbox

Run locally

cd backend  && npm i && npm run dev        # :4343
cd frontend && npm i && npm run dev        # set NEXT_PUBLIC_API_URL=http://localhost:4343
cd mobile   && npm i && npm start          # Expo Go

Copy backend/.env.example → .env. Without DATABASE_URL it runs in memory-only demo mode; without Gmail creds email notifications are skipped silently.

Deploy

• Backend → Render: render.yaml included (free tier). Set DATABASE_URL, ADMIN_TOKEN, optional GMAIL_USER/GMAIL_APP_PASSWORD.
• Frontend → Netlify: repo import picks up netlify.toml (static export). Attach custom domain mcp.djaouad.tech.
• Mobile → APK: eas build -p android --profile preview or expo run:android.

Connect in one paste

{ "mcpServers": { "hireme-mcp": { "url": "https://mcp.djaouad.tech/mcp" } } }

---

Built by Djaouad Frih — this server is itself the demo of what he ships.