# gumroad-mcp
## 基本信息
- Slug: `keithah-gumroad-mcp`
- Source: modelscope
- Publisher: @keithah/gumroad-mcp
- Categories: ecommerce-and-retail / customer-data-platforms / 金融
- Hosted: No
- License: Unknown
- Source URL: https://www.modelscope.cn/mcp/servers/@keithah/gumroad-mcp
## 简介
暂无描述。
## 安装提示

```bash
# Clone the repository git clone <your-repo-url> cd gumroad-mcp # Install dependencies npm install # Build the project npm run build # Run the server GUMROAD_ACCESS_TOKEN=your_token_here npm start
```

## MCP Server 详情

# Gumroad MCP Server

A Model Context Protocol (MCP) server for the Gumroad API, enabling AI assistants to look up subscription information, sales data, and product details.

## Features

- **Subscription Management**: Get subscriber lists and individual subscriber details
- **Sales Data**: Query sales with filters (date range, email, pagination)
- **Product Information**: Retrieve product listings and details
- **Type-Safe**: Written in TypeScript with comprehensive type definitions
- **Smithery Compatible**: Ready to deploy on Smithery.ai

## Available Tools

### Subscribers

- `get_subscribers` - Get all subscribers for a specific product
- `get_subscriber` - Get details for a specific subscriber

### Sales

- `get_sales` - Get all sales with optional filters (date range, email, pagination)
- `get_sale` - Get details for a specific sale

### Products

- `get_products` - Get all your Gumroad products
- `get_product` - Get details for a specific product

## Installation

### Using Smithery (Recommended)

1. Visit [Smithery.ai](https://smithery.ai)
2. Search for "gumroad-mcp" or install directly from this repository
3. Configure with your Gumroad access token
4. Deploy and use in Claude Desktop or other MCP clients

### Manual Installation

```bash
# Clone the repository
git clone <your-repo-url>
cd gumroad-mcp

# Install dependencies
npm install

# Build the project
npm run build

# Run the server
GUMROAD_ACCESS_TOKEN=your_token_here npm start
```

## Configuration

### Getting Your Gumroad Access Token

1. Go to https://gumroad.com/api
2. Click "Create an application"
3. Generate an access token
4. Copy the token for use in configuration

### Environment Variables

- `GUMROAD_ACCESS_TOKEN` (required) - Your Gumroad API access token

### Claude Desktop Configuration

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "gumroad": {
      "command": "node",
      "args": ["/path/to/gumroad-mcp/dist/index.js"],
      "env": {
        "GUMROAD_ACCESS_TOKEN": "your_token_here"
      }
    }
  }
}
```

## Usage Examples

### Get Product Subscribers

```
Get all subscribers for product ID "abc123"
```

The assistant will call `get_subscribers` with `product_id: "abc123"`.

### Query Sales by Email

```
Show me all sales for customer@example.com
```

The assistant will call `get_sales` with `email: "customer@example.com"`.

### Get Sales in Date Range

```
Show me all sales from January 2025
```

The assistant will call `get_sales` with appropriate `after` and `before` timestamps.

## API Response Examples

### Subscriber

```json
{
  "id": "sub_123",
  "product_id": "prod_abc",
  "product_name": "My Product",
  "user_email": "customer@example.com",
  "status": "alive",
  "recurrence": "monthly",
  "created_at": "2025-01-01T00:00:00Z"
}
```

### Sale

```json
{
  "id": "sale_123",
  "email": "customer@example.com",
  "product_name": "My Product",
  "price": 2900,
  "formatted_display_price": "$29",
  "timestamp": "2025-01-01T00:00:00Z",
  "is_recurring_billing": true,
  "subscription_id": "sub_123"
}
```

## Development

```bash
# Install dependencies
npm install

# Build in watch mode
npm run dev

# Build for production
npm run build

# Run the server
npm start
```

## API Permissions

The server requires a Gumroad access token with the following scopes:

- `view_sales` - To read sales and subscription data
- `view_profile` - To read product information

## Error Handling

All tools include comprehensive error handling. If an API call fails, you'll receive a descriptive error message explaining what went wrong.

## License

MIT

## Links

- [Gumroad API Documentation](https://gumroad.com/api)
- [Model Context Protocol](https://modelcontextprotocol.io)
- [Smithery](https://smithery.ai)