Username Inspector MCP server

Username Inspector MCP server

A free Model Context Protocol server for people who sell on resale marketplaces. It lets an AI assistant:

• look up whether a username or store name is free on eBay, eBay Store, Poshmark, Grailed, Vinted, Whatnot, Bonanza, Chairish, Depop, Etsy, Mercari, and Ruby Lane, and
• compare what a sale pays out after fees on eBay, Poshmark, Mercari, Depop, Etsy, Grailed, and Vinted.

It is the code behind Username Inspector. Documentation for end users is at https://usernameinspector.com/mcp/.

Use the hosted servers

No account, no API key.

The links-only server never contacts a marketplace. It builds the public profile page address for a username and leaves it to you to open it.

Claude Code

claude mcp add --transport http username-inspector https://usernameinspector.com/api/mcp

Clients with a JSON config (Cursor and others)

{
  "mcpServers": {
    "username-inspector": {
      "url": "https://usernameinspector.com/api/mcp"
    }
  }
}

Clients with a custom connector or remote server option: add a server and paste the URL.

It is also listed in the official MCP Registry as com.usernameinspector/username-inspector.

Tools

check_username

Looks up one username on up to 12 platforms. Each platform comes back as available, taken, unverified, or error, with a link to the profile page where one helps.

• username (required): 3 to 50 letters, numbers, hyphens, or underscores.
• platforms (optional): list of platform ids. Defaults to all twelve: ebay, ebaystore, poshmark, grailed, vinted, whatnot, bonanza, chairish, depop, etsy, mercari, rubylane.

Depop, Etsy, Mercari, and Ruby Lane block automated checks, so they always return a profile link. Poshmark, Vinted, and Bonanza usually return a live answer. eBay, eBay Store, Grailed, Whatnot, and Chairish often block automated lookups, and those come back as unverified with a link to check by hand. Which platforms answer can change at any time.

getprofilelinks (links-only server)

Builds the public profile page address for a username on each platform. Makes no requests to any marketplace.

compare_fees

Takes a sale price in USD and, optionally, shippingcharged, itemcost, shippingcost, and ebaypromotedratepercent. Returns fees and what you keep on seven platforms, best first, plus profit, margin, and ROI when costs are given. Estimates for US sellers, excluding sales tax, with the date each rate was last verified.

All tools are read-only and declare output schemas.

Limits and behavior

• About 12 tool calls per minute per client (HTTP 429 with Retry-After beyond that), 16 KB request bodies, 5 messages per batch.
• One username per check_username call. Results are cached in memory for 5 minutes per username and platform, and errors are never cached.
• Outbound lookups run at most 12 at a time per instance, with a 5 second timeout per platform and 9 seconds per call.
• Setting MCPDISABLED=1 turns both endpoints off. MCPLINKS_DISABLED=1 turns off only the links endpoint.

The in-process limits are per instance and best effort. On a serverless host, add a rate-limit rule at the platform level too.

Privacy

Shortened. The full README is on GitHub.