🤖MCP + REST API

Let your AI agent work Falahly for you

Falahly speaks the Model Context Protocol. Job seekers can tell their agent “find me roles that fit my CV and alert me”; employers can post a job from raw text in a single step. Scoped, revocable keys keep you in control.

One platform, two agents

Built for both sides of the market

🧑‍💻 For job seekers

MCP server: falahly.com/mcp/user/mcp

🔍
Personalized job search
Results ranked against your uploaded CV — your agent asks in plain language and gets the same matches you see.
🔔
Job alerts it can manage
Create, tune and pause saved-search alerts so the right roles come to you.
📄
Your CVs, on demand
The agent reads your CV content to tailor searches and answer questions.
✅
Apply — with your OK
Agents can submit applications, but only after confirming with you, and never more than 25 per day.

🏢 For employers

MCP server: falahly.com/mcp/employer/mcp

📝
Post jobs in one pass
Paste a raw job description — the LLM parses it into structured fields, ready to publish.
👥
Applicants & ranking
Fetch applicants with match scores, triage with interview ranks.
🎯
Candidate sourcing
Semantic search over the CV pool — by free text or a job’s requirements.
🔁
ATS sync
Mirror postings from Workable, Greenhouse or any JSON feed automatically.
How it works

Three steps, two minutes

1
Create an API key
In your Profile → AI Agents tab (job seekers) or the Employer Dashboard → API Keys tab. Copy it once — it’s never shown again.
2
Connect your agent
Add the MCP server to Claude, ChatGPT, or any MCP client with your key. Works with curl and REST, too.
3
Put it to work
Ask in plain language: search, alerts, applications — or posting and sourcing on the employer side.
# Connect any MCP client (e.g. Claude Code)
claude mcp add falahly-jobs \
--header "X-API-Key: flh_..." \
https://falahly.com/mcp/user/mcp

# Or plain REST (versioned, machine contract)
curl https://falahly.com/api/v1/jobs/search \
-H "X-API-Key: flh_..." \
-H "Content-Type: application/json" \
-d '{"description": "senior nurse", "city": "Riyadh"}'
Trust & safety

Powerful, never reckless

🔑
Scoped keys
Every agent key carries only the permissions you grant — nothing more.
🚫
Instantly revocable
Cut an agent off in one click. Keys are hashed and never shown twice.
⏱️
Rate-limited
Per-key daily quotas and burst limits stop runaway loops.
🛡️
Human in the loop
Applying is capped and confirmation-gated; agents can’t spam employers in your name.
Permissions reference

You decide what each key can do

Job seeker scopes

jobs:readSearch jobs, saved jobs, application status
alerts:manageCreate / update / delete job alerts
cv:readList CVs and read CV content
applications:writeApply to employer-hosted jobs

Employer scopes

jobs:readList company jobs and applicants
jobs:writePost / edit jobs, parse descriptions, rank applicants
sourcing:readCandidate sourcing search
analytics:readJob performance analytics
ats:manageRegister / import / remove ATS feeds

Your next agent hire is waiting

Spin up a key, connect your agent, and let it do the legwork — while you stay in charge.