HireMe MCP

io.github.djoudad292Published by GitHub account djoudad292v1.0.0Updated Oct 24, 2026

The first portfolio AI agents can hire. Profile, products, pricing and briefs over MCP.

VerifiedStreamable HTTPWeb executableProductivity & WorkflowBusiness & Commerce

Overview

AI-generated overview

A remote MCP server exposing a freelance AI engineer's profile, shipped projects, fixed pricing and availability, and letting an assistant file a project brief.

What you can do
Read the engineer's profile: identity, stack, live products, availability and contact links, with a prompt to call it first. Search shipped projects for proof of relevant experience. Retrieve fixed-price service pricing in USD with ETAs. Check current availability and get a direct booking link. Submit a project brief on the client's behalf, which is persisted and emailed for a fixed quote within 24 hours.
When to use it
Useful when evaluating or hiring this specific engineer: checking fit, pricing and availability, comparing against an agency, or delegating the filing of a requirements brief to an assistant.
Requirements
A remote Streamable HTTP endpoint; no authentication, environment variables or headers are declared. The README's local-run and deploy instructions (Node.js, database, admin token, Gmail credentials) apply only to self-hosting the backend.
Before you install
The submit_project_brief tool writes data: it persists the brief and sends it by email to the provider, and is rate limited per IP. Confirm scope with the human before filing. Pricing and availability come from the provider and are not independently verified.

Installation

In SourceWeft

  1. Open HireMe MCP in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.djoudad292%2Fhireme-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "hireme": {
      "type": "http",
      "url": "https://mcp.djaouad.tech/mcp"
    }
  }
}

README

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

ToolTypeWhat it does
get_profilereadIdentity, stack, live products, availability, contact links
search_projectsreadSemantic-ish search over shipped projects (proof of experience)
get_pricingreadFixed-price services in USD with ETAs
get_next_slotreadAvailability status + direct booking link
submit_project_briefwriteFiles 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 badgefrontend/   Next.js console (Netlify → mcp.djaouad.tech): connect configs,            live playground, scenariosmobile/     Expo app: profile, tool runner, admin briefs inbox

Run locally

bash
cd backend  && npm i && npm run dev        # :4343cd frontend && npm i && npm run dev        # set NEXT_PUBLIC_API_URL=http://localhost:4343cd 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

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

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

Demo

[HireMe MCP landing]

[MCP playground]

Demo video: MCP flow

Source: README.md at commit 53930c7

Tools

5

get_profile

Get Djaouad's profile

Who Djaouad Frih is: full-stack AI engineer, stack, live products, availability and contact links. Call this first.

Takes no parameters.

search_projects

Search shipped projects

Search Djaouad's production projects (AI receptionist, RAG document workspace, tool-calling support agent) for proof of relevant experience.

Parametersqueryrequired

get_pricing

Get pricing

Fixed-price service list in USD with ETAs. No hourly billing.

Takes no parameters.

get_next_slot

Check availability & book

Current availability status plus the direct booking link.

Takes no parameters.

submit_project_brief

Submit a project brief

File a project brief on the client's behalf. Djaouad replies with a fixed quote within 24 hours. Use after confirming scope with the human.

Parametersnamerequirednotesbudgetcontactrequiredfeaturestimelineproject_typerequired

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts