# Fiverr Mcp Server

> Search Fiverr gigs, sellers, pricing, and reviews. No API key required.

- **Type:** MCP server
- **Install:** `agentstack add mcp-kyurish-fiverr-mcp-server`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [KyuRish](https://agentstack.voostack.com/s/kyurish)
- **Installs:** 0
- **Category:** [Web & Browser](https://agentstack.voostack.com/c/web-and-browser)
- **Latest version:** 0.1.1
- **License:** MIT
- **Upstream author:** [KyuRish](https://github.com/KyuRish)
- **Source:** https://github.com/KyuRish/fiverr-mcp-server

## Install

```sh
agentstack add mcp-kyurish-fiverr-mcp-server
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Fiverr MCP Server

[](https://pypi.org/project/fiverr-mcp-server/)
[](https://opensource.org/licenses/MIT)

mcp-name: io.github.KyuRish/fiverr-mcp-server

MCP server for searching and browsing Fiverr - gigs, sellers, pricing, and reviews. No API key required.

## Features

- **Search gigs** by keyword with filters (price, seller level, category, sorting)
- **Get gig details** including pricing packages (Basic/Standard/Premium), description, and tags
- **View seller profiles** with certifications, languages, hourly rate, and gig listings
- **Read gig reviews** from the first page of any gig
- **List categories** to discover valid category slugs for filtered search
- All prices returned in **USD** (not cents)
- Built-in **rate limiting** and retry with browser fingerprint rotation
- Structured **error messages** on failures (no raw crashes)

## Installation

### Using uvx (recommended)

```json
{
  "mcpServers": {
    "fiverr": {
      "command": "uvx",
      "args": ["fiverr-mcp-server"]
    }
  }
}
```

### Using pip

```bash
pip install fiverr-mcp-server
```

### From source

```bash
git clone https://github.com/KyuRish/fiverr-mcp-server.git
cd fiverr-mcp-server
uv sync
uv run fiverr-mcp-server
```

## Configuration

Add to your Claude Desktop config (`claude_desktop_config.json`):

- **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`

```json
{
  "mcpServers": {
    "fiverr": {
      "command": "uvx",
      "args": ["fiverr-mcp-server"]
    }
  }
}
```

### Environment Variables

| Variable | Description | Default |
|----------|-------------|---------|
| `TRANSPORT` | Transport mode (`stdio` or `sse`) | `stdio` |
| `PROXY_URL` | Optional HTTP proxy for requests | - |
| `RATE_LIMIT_DELAY` | Minimum seconds between requests | `2` |

## Available Tools

### `search_gigs`
Search the Fiverr marketplace by keyword. Returns up to 48 gigs per page with pagination info.

**Parameters:**
- `query` (required) - Search query (e.g. "logo design", "python developer")
- `category` - Category slug (use `list_categories` to see valid values)
- `min_price` / `max_price` - Price range filter in USD
- `seller_level` - `"level_one_seller"`, `"level_two_seller"`, or `"top_rated_seller"`
- `sort_by` - `"relevance"`, `"best_selling"`, `"newest"`, `"price_asc"`, or `"price_desc"`
- `page` - Page number for pagination

**Returns:** List of gigs with title, price (USD), rating, reviews count, seller name, and URL. Also includes `total_results` and `has_more` for pagination.

### `get_gig_details`
Get full details of a specific gig including all pricing tiers.

**Parameters:**
- `url` (required) - Fiverr gig URL or path

**Returns:** Title, description, seller info, packages (name/price/delivery/revisions/features), tags, metadata, rating, reviews count, category, and orders in queue.

### `get_seller_profile`
Get a seller's profile. Use `seller_name` from search results as the username.

**Parameters:**
- `username` (required) - Seller's Fiverr username

**Returns:** Display name, bio, location, member since, languages, certifications, hourly rate (USD), gig listings, and verification status.

### `get_gig_reviews`
Get the first page of reviews for a gig (typically 5-10 reviews loaded from the page).

**Parameters:**
- `url` (required) - Fiverr gig URL or path

**Returns:** List of reviews with buyer name, country, rating, date, and text.

### `list_categories`
List all available Fiverr category slugs for use with `search_gigs`.

**Returns:** List of category objects with `slug` and `name`.

## Workflow Examples

**Finding a freelancer:**
1. `list_categories()` - see available categories
2. `search_gigs("3D character modeling")` - browse results
3. `get_gig_details(url)` - check pricing tiers (use URL from search results)
4. `get_seller_profile(seller_name)` - review their profile (use seller_name from search results)
5. `get_gig_reviews(url)` - read reviews

## Limitations

- **Reviews** - only the first page of reviews is available (Fiverr loads more via AJAX which requires authenticated requests)
- **Rate limiting** - Fiverr may block rapid requests. A 2-second minimum delay is enforced between requests (configurable via `RATE_LIMIT_DELAY`)
- **Data freshness** - all data is scraped from public pages in real-time, not cached

## How It Works

This server extracts structured data from Fiverr's public pages by reading the Perseus SSR data blob (``) that Fiverr's frontend framework embeds in every page. Uses `curl_cffi` for browser TLS fingerprint impersonation to handle Cloudflare protection, with automatic retry and fingerprint rotation.

## Responsible Use

This tool is intended for personal use - finding freelancers, comparing gigs, and reading reviews through an AI assistant. Please:

- Do not use for mass data harvesting or building databases of seller information
- Do not use for automated competitive monitoring at scale
- Respect Fiverr's infrastructure by keeping the default rate limit
- Be aware that web scraping may violate Fiverr's Terms of Service

## Development

```bash
git clone https://github.com/KyuRish/fiverr-mcp-server.git
cd fiverr-mcp-server
uv sync
uv run fiverr-mcp-server
```

## License

MIT

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [KyuRish](https://github.com/KyuRish)
- **Source:** [KyuRish/fiverr-mcp-server](https://github.com/KyuRish/fiverr-mcp-server)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.1 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.1** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-kyurish-fiverr-mcp-server
- Seller: https://agentstack.voostack.com/s/kyurish
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.