Skip to main content
Glama
modelnorth

fiverr-phantom-mcp

by modelnorth

πŸ‘» Fiverr Phantom

License: MIT Python: 3.10+ MCP: Enabled Engine: Patchright Stealth

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 --help

2. Connect Your Account (One-Time Interactive Login)

Launch a visible stealth browser window to log in:

fiverr-phantom --login
  • Complete 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 --status

4. 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 tools
fiverr_add_skillsC

Bulk-add search-indexed skills to the Fiverr seller profile. Levels: 'Beginner', 'Intermediate', 'Expert'

ParametersJSON Schema
NameRequiredDescriptionDefault
levelNoExpert
skillsYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

C2.9/5.0
Behavior2/5

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.

Conciseness5/5

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.

Completeness3/5

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.

Parameters2/5

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.

Purpose4/5

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.

Usage Guidelines2/5

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.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A4.1/5.0
Behavior3/5

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.

Conciseness5/5

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.

Completeness5/5

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.

Parameters4/5

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.

Purpose5/5

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.

Usage Guidelines3/5

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.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A4.1/5.0
Behavior3/5

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.

Conciseness5/5

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.

Completeness5/5

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.

Parameters4/5

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.

Purpose5/5

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.

Usage Guidelines3/5

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.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A3.6/5.0
Behavior3/5

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.

Conciseness4/5

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.

Completeness4/5

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.

Parameters4/5

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.

Purpose4/5

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.

Usage Guidelines3/5

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
taglineNo
descriptionNo

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A3.6/5.0
Behavior3/5

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.

Conciseness5/5

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.

Completeness2/5

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.

Parameters3/5

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.

Purpose5/5

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.

Usage Guidelines3/5

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.

  1. 5 tool updatesv0.1.0
    • First observedfiverr_add_skills
    • First observedfiverr_get_overview
    • First observedfiverr_get_status
    • First observedfiverr_launch_login
    • First observedfiverr_update_profile

TDQS

A3.7/5.0

Scored across 5 tools

Disambiguation5/5

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.

Naming Consistency5/5

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.

Tool Count5/5

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.

Completeness3/5

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

ActivityMaintained
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers