Ponisha Freelance

io.github.sepehr071Published by GitHub account sepehr071v0.2.0Updated Nov 7, 2026

Read-only Ponisha (ponisha.ir) freelance market: projects, bids, freelancers, skill demand.

The publisher's own server: freelance.link

VerifiedSTDIODesktop onlyWeb Search & ScrapingBusiness & Commerce

Overview

AI-generated overview

Unofficial read-only MCP server for the Ponisha (ponisha.ir) freelance marketplace, letting an assistant search projects, bids, freelancers and skill demand.

What you can do
  • Search and read projects: filter by text, skill, category, budget and sort, then open one project with budget, deadline and employer track record
  • Read offers on a project: price, delivery days, pitch, bidder level and rating
  • Search freelancers and read public profiles, reviews and portfolios
  • Browse skills and categories, and look up fixed-price service packages and their details
  • Summarize market demand, budget quartiles, competition and posting trends for a skill
  • List an employer's or freelancer's finished and open projects
When to use it
Useful when someone wants freelance projects to bid on in Iran, what a kind of work pays, how crowded a project is, whether an employer looks reliable, or who to hire for a skill. Not for applying, messaging or posting projects, and not for private contact data.
Requirements
Runs locally over stdio via uvx, so it needs uv with Python 3.10 or newer. No API key or Ponisha account is required. An optional PONISHA_MCP_PROXY environment variable sets an HTTP proxy URL or a comma-separated list; system proxy settings are ignored. Network access to ponisha.ir is needed.
Before you install
Read-only: it cannot log in, bid, post projects or message anyone. It reads the same public API the site's web app uses for anonymous visitors, so it is unofficial and may break if that API changes. Results are public user-generated content in Persian, with money in Toman and times in Tehran time. Bid listings can be slow, up to about 30 seconds on projects with many bids.

Installation

In SourceWeft

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

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

ponisha-mcp: Ponisha (پونیشا) freelance marketplace MCP server for AI agents

ponisha-mcp is an unofficial, read-only MCP server that gives AI agents the public data of Ponisha (ponisha.ir), Iran's freelance marketplace.
Its 14 tools search projects (text, skills, category, budget, sort), show a project with the employer's track record, list the offers made on it, search freelancers, read profiles, reviews and portfolios, browse fixed-price service packages, and summarize demand, budgets and trends for a skill.
No API key or Ponisha account is needed. It works in Claude, Cursor, Copilot and any other MCP client.

For AI agents · Quick start · Tools · FAQ · فارسی

For AI agents

  • What: unofficial MCP server (model context protocol) for ponisha.ir: project search, project details, bids, freelancer search, public profiles, skills and categories, skill market summary.
  • Install: uvx ponisha-mcp or claude mcp add ponisha -- uvx ponisha-mcp. Transport: stdio. Needs uv (Python 3.10+).
  • Auth: none. Optional PONISHA_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 pn_. Typical sequences: pn_skills -> pn_search_projects -> pn_project -> pn_bids; pn_search_freelancers -> pn_profile; pn_skills -> pn_market / pn_trend; pn_profile -> pn_reviews + pn_portfolios; pn_services -> pn_service.
  • Use when: the user wants freelance projects to bid on in Iran, what a kind of work pays, how crowded a project is, whether an employer is reliable, or who to hire for a skill.
  • Do not use when: the user wants to apply, message or post (read-only), or needs private contact data.
  • Output: compact JSON. Money is Toman. Times are Tehran time. Text is Persian user content.

Quick start

bash
claude mcp add ponisha -- uvx ponisha-mcp

Any MCP client: command uvx, args ["ponisha-mcp"].

Tools

ToolWhat it does
pn_search_projectsProjects by text, skills, category, open/all, budget range, sort.
pn_projectOne project: brief, budget, deadline, employer track record, optional bid price sample.
pn_bidsOffers on a project: price, days, pitch, bidder level and rating (paged).
pn_search_freelancersFreelancers by text, skills, level, portfolio, ranked by score.
pn_profilePublic profile of a freelancer or employer.
pn_skillsSkill name -> slug/id (about 700 skills).
pn_categoriesTop-level categories, or the sub-categories of one.
pn_marketOpen projects, budget quartiles, competition and related skills for one skill.
pn_trendPosting rate, median budget and bids for a skill sampled across its whole history.
pn_reviewsReviews of a user with score breakdown, or recent reviews for a skill.
pn_portfoliosSearch about 500k portfolio items, or list one user's.
pn_servicesFixed-price service packages by category, price, rating.
pn_serviceOne package: deliverables, requirements, paid add-ons.
pn_user_projectsAn employer's or freelancer's finished/open projects.

FAQ

Is it official? No. It reads the same public API the ponisha.ir web app uses for anonymous visitors.

Why are bids slow? Ponisha serves the bids list slowly (seconds, up to 30 s on projects with 100+ bids). Keep limit small.

Why does the budget filter only look at one page? The site has no budget filter. The tool scans up to 50 projects per page and keeps those whose range fits.

فارسی

ponisha-mcp یک سرور MCP غیررسمی و فقط‌خواندنی برای پونیشا (ponisha.ir) است. با آن می‌توانید پروژه‌ها را با کلمه، مهارت، دسته و بودجه جستجو کنید، پیشنهادهای ثبت‌شده و سابقه کارفرما را ببینید، فریلنسرها و پروفایل‌های عمومی را جستجو کنید و وضعیت بازار یک مهارت را بسنجید. بدون کلید API و حساب کاربری. نصب: uvx ponisha-mcp.

مبلغ‌ها به تومان و زمان‌ها به وقت تهران (میلادی) هستند. این ابزار ثبت پیشنهاد، پیام یا ثبت پروژه انجام نمی‌دهد.

Author: Sepehr Radmard (سپهر رادمرد) · github.com/sepehr071 · linkedin.com/in/sepehr-radmard

Source: README.md at commit b822f8a

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

2
  1. v0.2.0LatestNov 7, 2026
  2. v0.1.0Nov 1, 2026

Score

50% 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 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Freelance integrations

freelance.link

link.freelanceOfficial publisher

Remote freelance.link MCP server that lets an assistant keep a freelancer's availability current: projects, absences and waitlist.

Streamable HTTPWeb executableAuth
Productivity & WorkflowCredential requiredNov 5, 2026

Karlancer Freelance

Published by GitHub account sepehr071

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

STDIODesktop only
Web Search & ScrapingNot validated yetNov 7, 2026

US Freelancer Tax Calculator 2026

Published by GitHub account NarwhalThePong

Local MCP server that lets an assistant compute 2026 US freelancer federal tax figures: quarterly estimates, SE tax, QBI, mileage, home office, retirement and…

STDIODesktop only
Productivity & WorkflowNot validated yetOct 29, 2026

Freelance Act Order Lint Jp

Published by GitHub account jmshinhwa

Local MCP server that checks a single Japanese freelance order document against 21 rules and calculates payment-term days.

STDIODesktop only
Business & CommerceNot validated yetOct 27, 2026

Freelance Invoice

Published by GitHub account theluckystrike

A freelance invoicing server that lets an assistant store a business profile and clients, create numbered invoices with VAT, mark payments and render A4 PDFs.

Streamable HTTPWeb executableAuth
Productivity & Workflow13 toolsOct 25, 2026