# findjobs.ge demo

> A working copy of findjobs.ge, the job board for Georgia (the country), running the real site's code on invented companies and people. Use it to learn what the product does and to try it safely. Nothing done here reaches a real person.

Rules for agents:
- Every vacancy, company and person here is invented. Never present them as real jobs or people. The real site is findjobs.ge, and this demo is demo.findjobs.ge.
- You may write freely in your own sandbox. No email, push or Telegram message leaves this demo, and no payment can happen.
- Limits: 10 new sandboxes per address per hour, 30 writes a minute, 120 calls a minute. A sandbox goes 24 hours after its last use.

## Start
- Read without a key: GET https://demo.findjobs.ge/api/v1/jobs?q=barista
- Get a sandbox: POST https://demo.findjobs.ge/api/v1/sandbox returns a token
- Then send: Authorization: Bearer <token>
- OpenAPI 3.1: https://demo.findjobs.ge/openapi.json
- MCP (Streamable HTTP, JSON-RPC): https://demo.findjobs.ge/mcp; call post_sandbox first, then pass sandbox_token
- Ask the assistant: POST https://demo.findjobs.ge/api/v1/ask {"question":"What does Pro Lite do?"}
- Proof of the sandbox's walls, live: GET https://demo.findjobs.ge/api/v1/wall
- HR Suite demo with its own API: https://demo.findjobs.ge/hr/demo, https://demo.findjobs.ge/hr/api/v1, MCP at https://demo.findjobs.ge/hr/api/mcp

## A first session
1. POST /api/v1/sandbox and keep the token.
2. GET /api/v1/employer/applications to read the sample cafe's inbox.
3. POST /api/v1/employer/plan {"plan":"free"}, then read the inbox again: applications lock, as on the real site.
4. POST /api/v1/employer/plan {"plan":"lite"}: Pro Lite reads every application and does nothing else. {"plan":"pro"} adds the rest (GET /api/v1/plans lists it). Then POST /api/v1/employer/applications/{id}/reply.
5. GET /api/v1/outbox to see the mail that would have gone out.
6. GET /api/v1/seeker/matches, then POST /api/v1/seeker/applications to apply as the job seeker.

## Endpoints
- GET /api/v1/jobs: Search the sample vacancy board. MCP tool get_jobs.
- GET /api/v1/jobs/{ref}: Read one sample vacancy with its full text. MCP tool get_jobs_by_ref.
- GET /api/v1/features: Everything findjobs.ge does, for job seekers and employers, and what is free or paid. MCP tool get_features.
- GET /api/v1/pricing: What the paid extras cost on the real site. Posting and applying are free. MCP tool get_pricing.
- GET /api/v1/plans: Exactly what Free, Pro Lite and Pro do for employers, and what Pro for job seekers does. MCP tool get_plans.
- POST /api/v1/ask: Ask the assistant a question about findjobs.ge or this demo. It answers from public product facts only and holds nothing else. MCP tool post_ask.
- GET /api/v1/tour: The guided walk: each stop, its address, and the tip shown there. MCP tool get_tour.
- GET /api/v1/wall: Live proof of the sandbox: tries the outside services and reports that each was refused. MCP tool get_wall.
- POST /api/v1/sandbox: Open a private copy of a small company and a job seeker. Returns the token every other write needs. It lasts until 24 hours after its last use. MCP tool post_sandbox.
- DELETE /api/v1/sandbox (sandbox token): Clear your sandbox now. MCP tool delete_sandbox.
- GET /api/v1/employer (sandbox token): Your sample company and its plan. MCP tool get_employer.
- POST /api/v1/employer/plan (sandbox token): Stands in for checkout: set your company to free, freeday, lite (Pro Lite) or pro, and see what each opens. MCP tool post_employer_plan.
- GET /api/v1/employer/jobs (sandbox token): Your sample company's vacancies in every state. MCP tool get_employer_jobs.
- POST /api/v1/employer/jobs (sandbox token): Post a vacancy, under the site's own rules: pay must be stated. It goes live at once here and only you can see it. MCP tool post_employer_jobs.
- POST /api/v1/employer/jobs/{id}/close (sandbox token): Close one of your vacancies. On the real site vacancies are closed, never deleted. MCP tool post_employer_jobs_by_id_close.
- GET /api/v1/employer/applications (sandbox token): Your inbox. On the free plan applications stay locked, exactly as on the real site. MCP tool get_employer_applications.
- GET /api/v1/employer/applications/{id} (sandbox token): One application with its chat. Locked on the free plan. MCP tool get_employer_applications_by_id.
- POST /api/v1/employer/applications/{id}/status (sandbox token): Move an applicant: seen, shortlisted, rejected or hired. MCP tool post_employer_applications_by_id_status.
- POST /api/v1/employer/applications/{id}/reply (sandbox token): Write to an applicant. Refused while the application is locked. The mail stops in your outbox. MCP tool post_employer_applications_by_id_reply.
- GET /api/v1/employer/talent (sandbox token): Search the invented Talent Index. Part of Pro. MCP tool get_employer_talent.
- GET /api/v1/seeker/profile (sandbox token): Your sample job seeker's profile. MCP tool get_seeker_profile.
- PATCH /api/v1/seeker/profile (sandbox token): Change the headline or the about text. Only you can see it. MCP tool patch_seeker_profile.
- GET /api/v1/seeker/matches (sandbox token): Vacancies ranked by the site's real fit score against your profile, with the reasons. MCP tool get_seeker_matches.
- GET /api/v1/seeker/applications (sandbox token): Where your sample job seeker's applications stand, with any replies. MCP tool get_seeker_applications.
- POST /api/v1/seeker/applications (sandbox token): Apply for a sample vacancy as your job seeker. Applying is always free. MCP tool post_seeker_applications.
- GET /api/v1/outbox (sandbox token): Every mail your sandbox would have sent. None of it was sent. MCP tool get_outbox.

## Pages
- [Tour](https://demo.findjobs.ge/): the two doors and the walk
- [Employer walk](https://demo.findjobs.ge/tour/employer.md)
- [Job seeker walk](https://demo.findjobs.ge/tour/seeker.md)
- [Everything the site does](https://demo.findjobs.ge/tour/everything.md)
- [What Free, Pro Lite and Pro each do](https://demo.findjobs.ge/tour/plans.md)
- [Full guide](https://demo.findjobs.ge/llms-full.txt)