profilesearch/GohireHumans

The trusted marketplace where businesses, AI agents, and individuals hire verified human professionals on demand.
## For AI agents (MCP server)
GoHireHumans ships a Model Context Protocol (MCP) server so AI agents can find human help for small, scoped tasks that AI and software can't reliably finish alone. It is a Python stdio server with no third-party dependencies.
Install and run (uv, Python 3.9+):
bash
uvx --from 'git+https://github.com/profilesearch/GohireHumans#subdirectory=backend/mcp-package' gohirehumans-mcp
MCP client config (Claude Desktop, Cursor and other stdio clients):
json
"mcpServers": {
"gohirehumans": {
"command": "uvx",
"args": ["--from", "git+https://github.com/profilesearch/GohireHumans#subdirectory=backend/mcp-package", "gohirehumans-mcp"]
Browse and search, no key needed:
searchservices, getservicedetails: find services by task, category and price
searchworkers, getrecommended: compare providers by skill, rating and price, or rank listings for a task description
browsejobs, getcategories: see open jobs and service categories
getpricinginfo, getplatforminfo: fees and how the platform works
Account actions, need GOHIREHUMANSAPIKEY or GOHIREHUMANSAUTHTOKEN:
createjob: post a job
hireworker: hire a worker for a task
getjobstatus: track an order
releasepayment: approve completed work so the worker's listed payout is released
submitreview: rate a completed order
Hiring and payment actions require the account owner's authorization. Workers receive the listed payout; employers pay a 1% platform fee plus a fixed 3% processing charge where checkout is configured. GoHireHumans is not an escrow provider.
Package docs and authentication steps: backend/mcp-package/README.md. API docs: https://www.gohirehumans.com/api-docs.html. The MCP server is MIT-licensed (backend/mcp-package/LICENSE); the rest of this repository is proprietary (see LICENSE).
## Deployment guide
How the GoHireHumans site and API are built and deployed.
## Architecture
┌─────────────────────────┐ ┌──────────────────────────┐
│ Vercel (Frontend) │ ─────▶ │ Railway (Backend API) │
│ │ API │ │
│ index.html │ calls │ Flask + Gunicorn │
│ style.css │ │ SQLite database │
│ base.css │ │ Python 3.12 │
│ config.js │ │ │
└─────────────────────────┘ └──────────────────────────┘
Frontend: Static SPA (HTML/CSS/JS) hosted on Vercel
Backend: Python Flask API hosted on Railway (Docker)
Database: SQLite (file-based, included in container volume)
## Quick Start (Local Development)
### 1. Start the Backend
bash
cd backend
pip install -r requirements.txt
python server.py
The API will be running at http://localhost:8080. Test it:
bash
curl http://localhost:8080/health
# → {"status": "ok", "service": "gohirehumans-api"}
### 2. Seed Demo Data
Seeding is disabled unless SEEDSECRET is configured. Use it only for local/demo setup and unset it in production after controlled setup.
bash
curl -X POST http://localhost:8080/seed \
-H 'Content-Type: application/json' \
-d '{"secret":"YOURSEEDSECRET"}'
This creates local/demo marketplace records. Do not publish or rely on demo credentials for production.
### 3. Serve the Frontend
bash
cd frontend
# Any static file server works: