fiverr-phantom-mcp
Automates Fiverr seller account management, including updating profile bio and tagline, bulk-adding search-indexed skills, and checking session status.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@fiverr-phantom-mcpcheck my Fiverr session status"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
π» Fiverr Phantom
Fiverr Phantom is an autonomous, anti-ban automation suite and Model Context Protocol (MCP) server for Fiverr sellers. Built on C++ stealth-patched Chromium (
Patchright), it eliminates bot detection flags and enforces humanized behavioral heuristics (micro-jitter, variable keystrokes, non-linear scrolling) to safely manage profiles, update bios, bulk-add search-indexed skills, and interface directly with AI coding assistants (Claude Desktop, Cursor, Antigravity).
π‘οΈ Anti-Ban Architecture & Evasions
Fiverr utilizes Cloudflare and PerimeterX bot mitigation. Fiverr Phantom evades detection via 4 core mechanisms:
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β 1. C++ Patched Chromium (Patchright) β
β β’ Strips navigator.webdriver β
β β’ Removes CDP runtime detection flags β
β β’ Masks Canvas, WebGL, AudioContext & screen fingerprintsβ
ββββββββββββββββββββββββββββββββ¬βββββββββββββββββββββββββββββββ
β
ββββββββββββββββββββββββββββββββΌβββββββββββββββββββββββββββββββ
β 2. Humanized Keystroke Dispatch (Gaussian Delay) β
β β’ Randomized 35msβ100ms per character β
β β’ Natural punctuation pauses (0.2sβ0.4s on . , ! \n) β
ββββββββββββββββββββββββββββββββ¬βββββββββββββββββββββββββββββββ
β
ββββββββββββββββββββββββββββββββΌβββββββββββββββββββββββββββββββ
β 3. Non-Linear Mouse & Scroll Jitter β
β β’ Staggered multi-step scrolling for lazy loaders β
β β’ Pre-click human hovering delay β
ββββββββββββββββββββββββββββββββ¬βββββββββββββββββββββββββββββββ
β
ββββββββββββββββββββββββββββββββΌβββββββββββββββββββββββββββββββ
β 4. Isolated Local Session Encryption β
β β’ Cookies stored locally in ~/.fiverr-phantom/profile β
β β’ Zero plain-text credentials stored or transmitted β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββRelated MCP server: Superior Browser MCP
π Quickstart
1. Installation
git clone https://github.com/modelnorth/fiverr-phantom.git
cd fiverr-phantom
pip install -e .Or run instantly via uv:
uv run --with patchright fiverr-phantom --help2. Connect Your Account (One-Time Interactive Login)
Launch a visible stealth browser window to log in:
fiverr-phantom --loginComplete your email/password login and 2FA challenge.
Once the seller dashboard appears, close the browser window.
All authentication cookies are safely stored in your local persistent profile (
~/.fiverr-phantom/profile).
3. Verify Session Health
fiverr-phantom --status4. Optimize Profile Bio & Tagline
fiverr-phantom --update-bio \
--tagline "Sovereign AI Systems Architect | Defense-Grade Agent Security" \
--description "I engineer sovereign AI infrastructure, autonomous multi-agent orchestration, and defense-grade security kernels for enterprise and public-sector clients."5. Bulk-Add Search-Indexed Skills
fiverr-phantom --add-skills "Python,Artificial Intelligence,Machine Learning,Large Language Models (LLM),Autonomous Agents,Computer Vision,Cybersecurity,Cloud Computing" --level "Expert"π Model Context Protocol (MCP) Integration
Fiverr Phantom exposes native tools for AI assistants like Claude Desktop, Cursor, and Antigravity.
Client Configuration (mcp_config.json or claude_desktop_config.json):
{
"mcpServers": {
"fiverr-phantom": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/modelnorth/fiverr-phantom.git",
"fiverr-phantom-mcp"
]
}
}
}Exposed MCP Tools:
fiverr_get_status: Validates whether the local seller session is active.fiverr_update_profile: Updates profile description and tagline with humanized typing.fiverr_add_skills: Bulk-adds search-indexed skills with experience level.
π License & Disclaimers
Licensed under the MIT License.
Disclaimer: This is an independent, community-driven open-source project and is not affiliated with, endorsed by, or sponsored by Fiverr International Ltd. Users are responsible for adhering to Fiverr's Terms of Service.
Available Tools
5 toolsfiverr_add_skillsC
Bulk-add search-indexed skills to the Fiverr seller profile. Levels: 'Beginner', 'Intermediate', 'Expert'
| Name | Required | Description | Default |
|---|---|---|---|
| level | No | Expert | |
| skills | Yes |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden of explaining behavior. It states that skills are bulk-added and search-indexed, but it does not disclose whether the operation replaces existing skills, is additive, requires authentication, or what side effects may occur.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is extremely concise, front-loads the core action, and includes the only necessary additional detail about levels. Every sentence carries useful information with no filler.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the low complexity, an output schema, and only two parameters, the description is minimally adequate. However, it omits behavioral details such as whether existing skills are overwritten or appended, and it does not mention any usage prerequisites. These gaps matter for a mutation tool without annotations.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0%, so the description must compensate. It provides the allowed level values ('Beginner', 'Intermediate', 'Expert') and hints that skills are search-indexed, but the required 'skills' parameter receives no direct semantic explanation beyond its name and schema type.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly identifies a specific verb and resource: 'Bulk-add search-indexed skills to the Fiverr seller profile.' It conveys a distinct action that is not easily confused with the sibling tool names, though it does not explicitly contrast itself with them.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided about when to use this tool versus alternatives such as fiverr_update_profile or fiverr_launch_login. The description gives no context on prerequisites, suitable scenarios, or exclusions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
fiverr_get_overviewA
Inspect the authenticated Fiverr seller account: username, profile URL, and existing gigs.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the burden of behavioral disclosure. It notes that the account must be authenticated, which is important, and 'inspect' implies a non-destructive operation. However, it does not disclose any side effects, error conditions, or additional behavior beyond the listed return fields.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, focused sentence that immediately conveys the purpose and expected output. It is front-loaded with the core action and details, with no fluff or redundancy.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a no-parameter tool with an output schema, the description is highly complete. It explains what the tool does (inspect account), what it returns (username, profile URL, gigs), and implies the authentication requirement. There is nothing an agent needs to know to invoke it correctly that is missing.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The tool has zero parameters, so the schema is empty and schema description coverage is 100%. The description correctly implies that no arguments are needed. With no parameters to document, the baseline of 4 is appropriate, and the description adds no redundant parameter info.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's purpose: to inspect the authenticated seller account and returns specific data (username, profile URL, gigs). The verb 'inspect' is precise, and the resource is well-defined. It distinguishes itself from siblings by focusing on an account overview, though it doesn't explicitly name alternatives.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies usage for getting an overview of the seller account, but it does not explicitly state when to use this tool versus alternatives like fiverr_get_status or fiverr_update_profile. There are no exclusions or conditions provided, but the context is clear enough for a read-only inspection tool.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
fiverr_get_statusA
Check if the Fiverr Phantom browser session is authenticated and valid.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full burden of behavioral disclosure. 'Check' strongly implies a read-only, non-mutating operation, but the description does not explicitly state side effects, whether a session may be initialized, or what happens when authentication is missing. It is minimally adequate but not rich.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
One clear, front-loaded sentence that states the operation and target with no filler. Every word earns its place.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a zero-parameter, read-only status check with an output schema present, the description is sufficiently complete. The agent knows what the tool does, and the output schema can carry the return-value details.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The tool has zero parameters, so the description cannot add parameter-level meaning. The baseline of 4 applies because there are no parameter semantics to document and no risk of parameter ambiguity.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description names a specific verb ('Check'), a specific resource ('Fiverr Phantom browser session'), and the exact property being tested ('authenticated and valid'). It is clearly distinct from siblings like fiverr_get_overview and fiverr_launch_login, so an agent can tell what this tool does without opening the schema.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies this is a preflight status check for the browser session, which hints at when to use it, but it does not explicitly say when to use it versus alternatives or when not to use it. No siblings or conditions are named, so the agent must infer the usage context from the tool name and sibling list.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
fiverr_launch_loginA
Launch interactive visible window to log into Fiverr and persist the session.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
The description says the window is 'interactive' and 'visible', which is useful because it signals that the user will be involved and that headless operation is not possible. However, it does not disclose whether this requires user interaction each time or how the session is validated. No annotations are provided, so the description carries the burden; this is adequate but not rich.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is concise, a single sentence with no verbose filler, and it front-loads the key action and purpose. It loses a point for not elaborating on 'persist the session', which might be ambiguous, but overall it earns its place.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given that the tool has no parameters and an output schema exists (which likely describes the result), the description is fairly complete. It tells the agent that this opens a visible interactive window and persists the session, which is enough to invoke it correctly. However, it could mention that this is a prerequisite for other Fiverr tools, but that is not strictly necessary.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The tool has zero parameters, so the description doesn't need to explain any parameter semantics. The baseline for zero parameters is 4, and the description correctly avoids fabricating any parameter details. It could potentially explain that no input is needed, but that is obvious from the schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action (launch interactive visible window), the resource (Fiverr), and the goal (log in and persist the session). It is specific enough to distinguish from siblings like fiverr_get_status and fiverr_update_profile, though it could be more explicit about what 'persist' means.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies that this tool is for initiating login and session persistence, which is a prerequisite for other tools. However, it does not explicitly state when to use it versus alternative tools, nor does it mention when not to use it (e.g., when a session already exists).
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
fiverr_update_profileA
Update seller profile description and/or tagline on Fiverr with anti-ban humanized timing.
| Name | Required | Description | Default |
|---|---|---|---|
| tagline | No | ||
| description | No |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description must disclose behavioral traits. It mentions 'anti-ban humanized timing', which hints at deliberate pacing to avoid detection, but does not explain side effects, reversibility, or whether an active session is required. It discloses some behavior but leaves significant gaps for a mutation tool.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, front-loaded sentence that states the action and the anti-ban timing without any filler. Every word contributes to the tool's purpose and a notable behavioral trait. It is highly concise and well-structured.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a mutation tool with no annotations, the description is incomplete. It does not mention prerequisites (e.g., having logged in via fiverr_launch_login), whether the update is partial or full, or what the return value indicates. The output schema exists but is not described, and the timing behavior is vague. An agent would lack guidance on failure handling or session requirements.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 0%, so the description must clarify parameters. It names 'description and/or tagline', directly mapping to the two schema fields. However, it adds no constraints, length limits, or examples. It clarifies what the parameters are for but does not enrich the schema beyond the field names themselves.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action (update) and the resource (seller profile description and/or tagline on Fiverr). It is specific and distinguishes from sibling read tools like get_status and get_overview, and from add_skills, by naming exactly what is updated. No ambiguity about the tool's core function.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies usage for modifying profile text, but does not explicitly state when to use this tool versus alternatives. It does not mention that add_skills is for skills or that login is a prerequisite. No when-not guidance is given, so it relies on the agent inferring from context.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
5 tool updates
v0.1.0- First observed
fiverr_add_skills - First observed
fiverr_get_overview - First observed
fiverr_get_status - First observed
fiverr_launch_login - First observed
fiverr_update_profile
TDQS
Scored across 5 tools
Each tool targets a distinct concern: authentication status, account overview, login flow, profile description/tagline updates, and skill additions. The boundaries between update_profile and add_skills are clear because they modify different parts of the profile.
All tools use a consistent fiverr_ prefix followed by a clear verb_noun pattern: get_status, get_overview, launch_login, update_profile, add_skills. Naming style and structure are uniform across the set.
Five tools is a well-scoped set for a focused Fiverr automation server. Each tool covers a necessary step in the login-to-profile-management workflow without unnecessary bulk.
The core profile workflow is coveredβlogin, status check, overview, profile update, and skill additionβbut the skill management surface is one-directional. There is no way to retrieve existing skills, remove them, or adjust their levels, which creates a notable gap for full profile management.
Maintenance
Related MCP Connectors
Stealth web automation for AI agents. Login, signup, navigate, screenshot.
Stealth web automation for AI agents. Login, signup, navigate, screenshot.
Give AI agents the LinkedIn tools to find, qualify, engage, and follow up with prospects.
AI-powered browser automation β navigate, click, fill forms, and extract data from any website.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI assistants to manage Fiverr seller accounts directly from the browser session. Supports gig management, order tracking, messaging, analytics, and profile updates without API keys.14MIT
- FlicenseCqualityDmaintenanceEnables AI-powered browser automation with real profiles, supporting interaction, navigation, form filling, and advanced features like visual overlays and self-healing selectors.421-
- FlicenseAqualityDmaintenanceEnables AI assistants to interact with the Upwork freelance marketplace, including job search, proposal management, contract tracking, and earnings monitoring.261-
- AlicenseCqualityBmaintenanceEnables AI assistants to interact with the AIGigLab API for lead generation, LinkedIn automation, voice cloning/TTS, and visual asset generation.3720 npmMIT