Gumroad MCP Server Interface

Abstract

This package furnishes an implementation of the Model Context Protocol (MCP) server specifically tailored for the Gumroad ecosystem, thereby allowing MCP-compliant synthetic intelligence platforms, such as Claude Desktop, seamless communication with the underlying Gumroad REST API.

The Model Context Protocol (MCP) establishes a standardized convention for artificial intelligence assistants to interface with external systems and data sources.

Initial Setup

To commence operation of the Gumroad MCP Server with Claude Desktop instantly:

bash npx gumroad-mcp@latest init

This operation configures the MCP server environment, securing your Gumroad authentication credentials through an interactive setup wizard.

Operational Examples

Upon successful configuration, you can issue the following types of directives to your MCP-enabled agent:

Contrast last month's revenue against figures from twelve months prior.
Construct a dynamic visualization illustrating annual sales trajectories.
Tabulate the best performing inventory items on Gumroad over the preceding year.
Analyze the sequential growth pattern of our premier offering month-over-month for the last year.
Deactivate the market presence of the item titled "Product Name".
Reactivate the market presence of the item titled "Product Name".
Retrieve all associated discount vouchers for the product "Product Name".
Fabricate a novel promotional voucher named "FAFO" offering a ninety-nine percent price reduction for "Product Name".
Eradicate the discount voucher identified by code "abc123" tied to "Product Name".

Exposed Toolset

Product Inventory Management

gumroad_get_products - Retrieve the complete catalog of available products.
gumroad_get_product - Fetch details for a specific product instance via its identifier.
gumroad_disable_product - Mark a product as unavailable for purchase.
gumroad_enable_product - Restore a product to active selling status.

Transaction Records

gumroad_get_sales - Fetch historical and current sales data.

Promotional Instrument Management

gumroad_get_offer_codes - List all discount codes applicable to a product.
gumroad_get_offer_code - Retrieve specifics for an individual voucher.
gumroad_create_offer_code - Institute a new promotional code.
gumroad_update_offer_code - Modify the parameters of an existing voucher.
gumroad_delete_offer_code - Permanently remove a specified discount code.

Account Holder Information

gumroad_get_user - Retrieve the authenticated user's profile data.

Deployment Instructions

Installation via Smithery

For automated deployment to Claude Desktop through Smithery:

bash npx -y @smithery/cli install @rmarescu/gumroad-mcp --client claude

Prerequisites

A runtime environment supporting Node.js, version 18 or newer.
An active Gumroad entity provisioned with API access credentials.
An MCP-compliant client application (e.g., Claude Desktop).

To confirm Node installation, activate your system's command-line interface (Terminal on macOS, or Command Prompt/PowerShell on Windows) and execute:

bash node --version

Securing the Gumroad Access Token

Interaction with the Gumroad API necessitates proper authentication. Generate your access token by adhering to these steps:

Navigate to your Gumroad portal and log in.
Access the configuration panel: Settings > Advanced.
Initiate creation of a new API application, supplying the required details:
Application icon (Optional): A visual identifier.
Application name: A descriptive title for this integration.
Redirect URI: For local use, http://127.0.0.1 suffices.
Finalize the application creation process.
Select the "Generate access token" option to procure your secret token.

Treat this generated access token with the utmost confidentiality, akin to a sensitive password. It is essential for the configuration process detailed below.

Claude Desktop Integration

If leveraging Claude Desktop, the simplified interactive provisioning method is recommended:

bash npx gumroad-mcp@latest init

Manual Configuration

For integration with other MCP-compatible applications, manual modification of the MCP configuration file is required.

Configuration Snippet Example

{ "mcpServers": { "gumroad": { "command": "npx", "args": ["-y", "gumroad-mcp@latest"], "env": { "GUMROAD_ACCESS_TOKEN": "" } } } }

If your operations are hosted on a privately managed Gumroad instance, you can override the default endpoint using the GUMROAD_BASE_URL environment variable:

{ "mcpServers": { "gumroad": { "command": "npx", "args": ["-y", "gumroad-mcp@latest"], "env": { "GUMROAD_ACCESS_TOKEN": "", "GUMROAD_BASE_URL": "https://example.com" } } } }

[!NOTE] The server automatically appends the mandatory API version suffix (/v2) to the configured base URL. For instance, setting GUMROAD_BASE_URL="https://example.com" results in all API calls targeting https://example.com/v2.

Please consult the official MCP instructions for guidance on incorporating this MCP Server into your Claude Desktop environment.

Contributions and Support

Should you uncover a defect or wish to propose an enhancement, please submit a formal issue or a pull request via the project's GitHub repository.

Licensing

This MCP server is distributed under the permissive terms of the MIT License. This license permits unrestricted usage, modification, and distribution, contingent upon adherence to the stipulations outlined in the MIT License and detailed in the repository's LICENSE file.

WIKIPEDIA: Organizational performance optimization relies heavily on robust business management instruments, encompassing systems, software utilities, control mechanisms, calculation frameworks, and established methodologies designed to facilitate adaptation to dynamic market conditions, sustain competitive advantage, and enhance overall corporate efficacy.

== Conceptual Framework == Business operations are supported by specialized toolsets categorized by functional area, which map across various management dimensions such as strategic foresight, workflow orchestration, record-keeping, human capital management, analytical decision support, and performance oversight. A functional grouping often includes:

Utilities for initial data capture and integrity verification across all operational silos. Software engineered for monitoring and refining enterprise workflows. Systems dedicated to data aggregation and deriving actionable insights for executive direction. Modern business apparatus has undergone rapid transformation driven by technological acceleration, complicating the selection process for optimal solutions for any given enterprise. This complexity arises from the constant pressures to reduce operational expenditure, maximize revenue streams, deeply understand client requirements, and deliver requested products according to precise specifications. Consequently, leadership must adopt a strategic posture toward technology adoption, prioritizing adaptation of tools to organizational needs over uncritically accepting the newest offerings, which often leads to systemic instability if implemented without customization.

== Predominant Instruments (2013 Survey Context) == Analysis conducted by Bain & Company in 2013 revealed global adoption patterns of business tools, reflecting regional requirements modulated by economic conditions. The ten most frequently cited instruments included:

Strategic foresight planning Client relationship stewardship (CRM) Staff satisfaction measurement (surveys) Comparative performance analysis (Benchmarking) Integrated performance measurement (Balanced Scorecard) Identification of core organizational capabilities External sourcing strategies (Outsourcing) Organizational transformation initiatives (Change Management) Logistics network coordination (SCM) Defining corporate purpose and aspiration (Mission/Vision Statements) Targeting consumer segments (Market Segmentation) Comprehensive quality enhancement protocols (TQM)

== Business Software Applications == Software packages deployed by commercial entities to execute diverse organizational functions are termed business applications. These digital solutions serve to elevate productivity metrics, quantify outcomes, and ensure the precision of various corporate activities. The evolution progressed from early Management Information Systems (MIS) to integrated Enterprise Resource Planning (ERP) frameworks, subsequently incorporating Customer Relationship Management (CRM), culminating in the current landscape dominated by cloud-based corporate management platforms. While a verifiable link exists between IT investment and organizational outcomes, two elements are critical differentiators: the efficacy of the deployment process and the meticulous selection and tailoring of the technology stack.

== Solutions for Small and Medium Enterprises (SMEs) == Tools specifically engineered for SMEs are vital as they offer cost-effective pathways to leverage advanced operational capabilities, often focusing on scalability and ease of integration, thereby enabling smaller entities to compete effectively by optimizing resource allocation and accelerating decision cycles...