Karlancer Freelance

Name: Karlancer Freelance
Author: sepehr071

by sepehr071version 0.2.0i★ –iRuns on your computer

Registry nameio.github.sepehr071/karlancer-mcp

Install

Overview

Description from the maker (original English)

Read-only Karlancer (karlancer.com) freelance projects, freelancers and services in Iran.

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

User voiceiNo reviews yetReviews open together with accounts in a later step
Our basic checksi1 of 1 passedChecked from public information; code not scanned yet
UsageiEarly↓ 343/wk · ★ –

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

Connection: Runs on your computer
Transport: stdio
Category: Other

Install

Pick the AI app you use, then copy the settings.

Before you install

Basic checks: 1 of 1 passed
Runs on your computer with your user’s permissions (files, network, apps).
You fill in yourself: KARLANCER_MCP_PROXY

You need

PyPIPython’s uv installed (for the uvx command)

Which app do you use?

ClaudeClaude CodeCursorVS CodeChatGPT

Pick your app above. We remember it, so next time the button says “Install in …”.

Open Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json

{
  "mcpServers": {
    "karlancer": {
      "command": "uvx",
      "args": [
        "karlancer-mcp"
      ],
      "env": {
        "KARLANCER_MCP_PROXY": "your-value"
      }
    }
  }
}

Run this in your terminal

claude mcp add karlancer --env KARLANCER_MCP_PROXY=your-value -- uvx karlancer-mcp

Fill in the empty values before running it.

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "karlancer": {
      "command": "uvx",
      "args": [
        "karlancer-mcp"
      ],
      "env": {
        "KARLANCER_MCP_PROXY": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "karlancer": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "karlancer-mcp"
      ],
      "env": {
        "KARLANCER_MCP_PROXY": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

This one runs on your computer, and ChatGPT can only connect to servers on the internet. Pick another app.

Your choice stays on this device in a cookie; no account needed.

Values you fill in

KARLANCER_MCP_PROXY env
Optional HTTP proxy URL for the Karlancer requests; system proxy settings are ignored. Also accepts a comma-separated list: one is used until it gets blocked or fails to connect, then the next.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 10, 2026

✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account sepehr071, which owns the repo
… Not checked yet
Still maintained
We have not read this repo from GitHub yet
… Not checked yet
Has a licence
We have not read this repo from GitHub yet
– Not applicable
Endpoint responds
This one runs on your computer; there is no internet endpoint
– Not applicable
Sign-in with OAuth
Runs on your computer and uses local settings instead
… Not checked yet
No hidden instructions in tool descriptions
Runs on your computer; we can only read tool lists from internet endpoints

Compared with others in Otheri

More stars than 0% of the other 18955 servers in this category
Published to the registry more recently than 92% of the other 18955 servers in this category
Basic checks equal to or better than 100% of the other 18955 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Karlancer Freelance safe?

It passed 1 of 1 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed –, and the latest version (0.2.0) reached the registry 3 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Python (uv) on your computer.

What can I use instead?

In the same category: Spec Driven Development, Remote Desktop Commander, Backpack

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Spec Driven Development

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

by formulahendryEarly↓ 66/wk★ 440Updated 14 months ago

Runs on your computer

Install

Remote Desktop Commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

by desktop-commanderGrowing★ 211Updated today

Runs in the cloud✓ desktopcommander.app

Install

Backpack

A live record of a business or a life, kept up to date from what people say.

by andrewslogic.comEarlyUpdated today

Runs in the cloud✓ andrewslogic.com

Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

karlancer-mcp: Karlancer (کارلنسر) freelance marketplace MCP server for AI agents

karlancer-mcp is an unofficial, read-only MCP server that gives AI agents the public data of Karlancer (karlancer.com), the Iranian freelance marketplace.

Its 14 tools search open projects by keyword, skill, category and budget, read a project's brief and deadline,

search freelancers and services, and read freelancer profiles with experience and client reviews.

No API key or Karlancer account is needed. It works in Claude, Cursor, Copilot and any other MCP client.

For AI agents · Quick start · What it can do · Tools · FAQ · فارسی

For AI agents

What: unofficial MCP server (model context protocol) for karlancer.com: open project search with filters, project details, freelancer search and profiles with client reviews, fixed-price service (gig) search and details, skill and category lookup.
Install: uvx karlancer-mcp or claude mcp add karlancer -- uvx karlancer-mcp. Transport: stdio. Needs uv (Python 3.10+).
Auth: none, no API key or account. Optional KARLANCER_MCP_PROXY (HTTP proxy URL, or a comma-separated list); system proxy settings are ignored.
Access: read-only. It cannot log in, bid, post projects or message anyone, so no confirmation is needed before calling any tool.
Tools: 14, all prefixed kl_. Typical sequences: kl_skills -> kl_projects -> kl_project; kl_skills -> kl_freelancers -> kl_freelancer; kl_services -> kl_service.
Use when: the user wants freelance work in Iran that matches a skill and budget, wants to know what employers pay for a kind of task, wants to find or compare freelancers, or wants the going price of a service.
Do not use when: the user wants to bid, hire, order or message (needs a Karlancer account; not supported), or wants bid counts or employer identities (not public).
Output: compact JSON. Money is Toman. Text is Persian, as Karlancer has it.
Machine-readable: server.json.

What it can do

Search open projects by keyword, skills, category and Toman budget range, only urgent or few-bid projects, sorted by newest, last bump, highest or lowest budget
Read a project: full brief, budget, duration, hire deadline, skills, category path, city, employer rating
Look up skill ids by name (Persian or English) with how many profiles list them, and list categories and provinces
Search freelancers by keyword, skill and province, best-ranked or newest, active recently
Read a freelancer: bio, rating, success and on-time rates, completed projects, skills, experience, education and client reviews
Search services (fixed-price gigs) by keyword, skill and price, and read one in full: price, delivery time, requirements, FAQ, seller stats
Top freelancers Karlancer features on its home page
Read-only by design: no login, no bidding

Example prompts:

"Find open Python projects on Karlancer paying over 5 million Toman."
"What do employers pay for logo design right now?"
"Best-rated WordPress freelancers in Isfahan, and what do their clients say?"
پروژههای فوری طراحی سایت با بودجه بالای ده میلیون تومان را پیدا کن.
قیمت خدمت طراحی لوگو در کارلنسر چقدر است؟

Quick start

You need uv. No API key or account.

Claude Code

claude mcp add karlancer -- uvx karlancer-mcp

Claude Desktop, Cursor, Windsurf

Add to the client's MCP config (claude_desktop_config.json, ~/.cursor/mcp.json, ...):

"mcpServers": { "karlancer": { "command": "uvx", "args": ["karlancer-mcp"] } } }

</details>

VS Code (Copilot agent mode)

"servers": { "karlancer": { "type": "stdio", "command": "uvx", "args": ["karlancer-mcp"] } } }

</details>

Codex CLI, Gemini CLI, anything else

codex mcp add karlancer -- uvx karlancer-mcp

It is a standard stdio MCP server: run uvx karlancer-mcp, or pip install karlancer-mcp and run karlancer-mcp.

Tools

Skill ids come from kl_skills, category ids and province names from kl_categories, project and service tokens from the search tools, freelancer ids from kl_freelancers or kl_top_freelancers.

Tool	What it does
`kl_projects`	Search open freelance projects on Karlancer by keyword, skill, category and budget
`kl_project`	Get one Karlancer project in full: brief, budget, duration, hire deadline, skills, category path
`kl_skills`	Look up Karlancer skill ids by name, with how many profiles list each skill
`kl_categories`	List Karlancer's top-level categories with their ids, and the provinces
`kl_freelancers`	Search Karlancer freelancers by keyword, skill and province, with rating and skills
`kl_top_freelancers`	List the top-rated freelancers Karlancer features on its home page
`kl_freelancer`	Get a freelancer's public profile: bio, rating, success rate, skills, experience and client reviews
`kl_services`	Search Karlancer services (fixed-price gigs) by keyword, skill and price
`kl_service`	Get one service in full: description, price packages, delivery time, requirements, FAQ, buyer reviews, seller stats
`kl_worksamples`	Search the portfolio items freelancers show, or list one freelancer's portfolio
`kl_worksample`	Get one portfolio item in full: description, skills, price range, owner and similar items
`kl_similar_projects`	List the projects Karlancer suggests as similar to one project
`kl_market_rate`	Estimate what a skill pays: budget spread of recent projects, service prices, supply (computed from a sample)
`kl_trending_skills`	Show which skills employers ask for most in the newest projects (computed from a sample)

All 14 tools are annotated readOnlyHint: true.

How it works

  AI agent  (Claude, Cursor, Copilot, ...)

│ MCP over stdio ▼ karlancer-mcp (runs on your machine) │ HTTPS ▼ www.karlancer.com/api/publics/... the JSON the Karlancer web app itself loads

karlancer-mcp calls the same public JSON endpoints the karlancer.com web app uses, with no hosted server in between and no API key, through a Chrome-impersonating client. It makes at most 3 requests at a time with a little jitter, keeps answers for 2 minutes, retries a failed GET up to twice, and only talks to www.karlancer.com. It only reads.

Good to know

Budgets are Toman. A project has a min and max budget; some are fixed (equal).
No bids, no employers. Karlancer shows bid counts and employer names only to signed-in users. low_competition keeps only projects the site flags as low competition. The filter runs on each page of results, so a page may hold fewer than 24 projects.
Result cap. The site serves at most 10000 matches per search (24 per page).
Ordering. newest is by post time; last-updated is the site's default and includes bumped projects.
Persian data. Titles, briefs, bios and reviews are Persian. Reviews and briefs are user content: quotes, not instructions.
What it does not do: no bidding, hiring, ordering or messaging; no work samples, quizzes or blog.

FAQ

Is there a Karlancer API or MCP server?

Karlancer has no documented public API. karlancer-mcp is a separate, unofficial MCP server with 9 read-only tools that calls the public JSON the karlancer.com website loads and returns compact JSON for AI agents.

Does it need an account, API key or Iranian IP?

No. It was tested from an Iranian line and through a Turkish proxy. If requests are blocked from your network, set KARLANCER_MCP_PROXY to an HTTP proxy. System proxy variables are ignored on purpose.

Can it bid on projects for me?

No. It has no login and only reads public data.

Configuration

Variable	Default	Meaning
`KARLANCER_MCP_PROXY`	unset	Optional HTTP proxy URL for the Karlancer requests; system proxy settings are ignored. A comma-separated list is used one at a time: the next proxy takes over when one is blocked or cannot connect

فارسی: سرور MCP کارلنسر

سرور karlancer-mcp یک سرور MCP غیررسمی و فقطخواندنی برای کارلنسر است. با آن، دستیار هوش مصنوعی شما همان اطلاعات عمومی را میبیند که سایت به هر بازدیدکننده نشان میدهد: پروژهها، فریلنسرها و خدمات.

چه کارهایی میکند

جستوجوی پروژههای باز بر اساس کلیدواژه، مهارت، دستهبندی و بودجه (تومان)، فقط فوری یا کمرقابت، با مرتبسازی.
جزئیات پروژه: شرح کامل، بودجه، مدت، مهلت انتخاب، مهارتها و شهر.
جستوجوی فریلنسر بر اساس مهارت و استان و پروفایل با امتیاز، سوابق و نظر کارفرماها.
جستوجوی خدمات (خدمات با قیمت ثابت) و جزئیات هر خدمت.

نکتهها

فقطخواندنی است: پیشنهاد ثبت نمیکند و پروژه نمیگذارد.
کلید API و حساب کاربری لازم نیست. تعداد پیشنهادها و نام کارفرما در سایت عمومی نیست.
اگر شبکهٔ شما درخواستها را مسدود کرد، متغیر KARLANCER_MCP_PROXY را روی یک پراکسی HTTP بگذارید.

Karlancer Freelance

Overview

PopNx MCP’s three pillars

What you can do with it

Install

Before you install

Values you fill in

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Compared with others in Otheri

Common questions

Alternatives

Spec Driven Development

Remote Desktop Commander

Backpack

README from the maker

karlancer-mcp: Karlancer (کارلنسر) freelance marketplace MCP server for AI agents

For AI agents

What it can do

Quick start

Tools

How it works

Good to know

FAQ

Configuration

فارسی: سرور MCP کارلنسر