envato-mcp

A Model Context Protocol (MCP) server for the Envato API. It lets MCP-compatible AI clients (Claude Desktop, Cursor, and others) search the Envato Market catalog, look up author statistics, inspect a buyer's purchases, and read the authenticated user's account details.

Features

Catalog search — full-text item search, popular items, and category listings across Envato Market sites (ThemeForest, CodeCanyon, etc.).
Author stats — public user info, item counts by site, badges, and market-wide totals.
Buyer / purchases — list your purchases, fetch download links, and verify purchase codes.
Account info — the authenticated user's account, username, and email.

Every tool validates its input with zod and returns the raw Envato JSON response. API errors (including 401/403 auth failures and 429 rate limiting) are surfaced as clear, actionable messages.

Requirements

Node.js 18 or newer.
An Envato personal token (see below).

Getting an Envato token

Go to https://build.envato.com/create-token/.
Select the permissions you need. For example:
- View and search Envato sites — catalog tools.
- View your Envato Account username / email — account tools.
- View your items' sales history / List purchases you've made — buyer tools.
- Download your purchased items — download links.
Create the token and copy it. You will pass it to the server as the ENVATO_TOKEN environment variable.

Usage

Run directly with npx (no install required):

ENVATO_TOKEN=your-token-here npx envato-mcp

The server communicates over stdio and is intended to be launched by an MCP client rather than used interactively.

Claude Desktop

Add the server to your claude_desktop_config.json:

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

{
  "mcpServers": {
    "envato": {
      "command": "npx",
      "args": ["-y", "envato-mcp"],
      "env": {
        "ENVATO_TOKEN": "your-token-here"
      }
    }
  }
}

Cursor

Add the server to ~/.cursor/mcp.json (or .cursor/mcp.json in a project):

{
  "mcpServers": {
    "envato": {
      "command": "npx",
      "args": ["-y", "envato-mcp"],
      "env": {
        "ENVATO_TOKEN": "your-token-here"
      }
    }
  }
}

After saving, restart the client so it picks up the new server.

Tools

Catalog search

Tool	Description	Arguments
`envato_search_items`	Search the catalog for items matching a term.	`term` (string, required), `site` (string, optional), `page` (int, optional), `page_size` (int 1–100, optional)
`envato_popular_items`	Most popular items for a site.	`site` (string, e.g. `themeforest`)
`envato_categories`	All categories for a site.	`site` (string, e.g. `codecanyon`)

Author stats

Tool	Description	Arguments
`envato_user_info`	Public account details for a user.	`username` (string)
`envato_user_items_by_site`	Number of items a user sells per site.	`username` (string)
`envato_user_badges`	Badges earned by a user.	`username` (string)
`envato_market_totals`	Total users and items across Envato Market.	none

Buyer / purchases

Tool	Description	Arguments
`envato_list_purchases`	List the authenticated buyer's purchases.	`filter_by` (enum, optional), `page` (int, optional)
`envato_download_link`	Download URL for a purchased item.	`item_id` (int)
`envato_verify_purchase`	Verify a purchase code and return sale details.	`code` (string)

Account info

Tool	Description	Arguments
`envato_account`	The authenticated user's account details.	none
`envato_my_username`	The authenticated user's username.	none
`envato_my_email`	The authenticated user's email.	none

Development

npm install        # install dependencies
npm run dev        # rebuild on change (tsup --watch)
npm run typecheck  # type-check with tsc (no emit)
npm run lint       # lint with ESLint
npm run build      # bundle to dist/ with tsup

The build outputs an executable ESM bundle to dist/index.js with a Node shebang, wired up as the envato-mcp bin.