Neptime MCP Server

MCP (Model Context Protocol) server for Neptime.io video platform API integration.

Features

This MCP server provides 40+ tools for interacting with the Neptime.io API:

Videos

• List, search, and get trending videos
• Get video details
• Update and delete your videos
• Rate videos (like/dislike)

Video Uploads (NEW in v1.1.0)

• Chunked upload for large files (up to 10GB for pro users, 1GB for free)
• Bypasses Cloudflare's 100MB limit with 50MB chunks
• Upload progress tracking

Channels

• Get channel information
• Get channel videos
• Subscribe/unsubscribe from channels
• View your subscriptions

Playlists

• Create, update, and delete playlists
• Add/remove videos from playlists
• View playlist details

Comments

• Get video comments
• Post comments on videos
• Delete your comments
• Rate comments

Articles

• List and get articles
• Create, update, and delete articles

History & Watch Later

• View watch history
• Clear watch history
• Manage watch later list

Categories

• Get all categories
• Get videos by category

Reports

• Report videos for violations

Installation

npm install -g neptime-mcp-server

Or run directly with npx:

npx neptime-mcp-server

Configuration

Get Your API Key

1. Go to https://neptime.io/settings/api_keys
2. Create a new API key with the required scopes
3. Copy the API key

Environment Variable

Set the NEPTIME_API_KEY environment variable:

export NEPTIME_API_KEY="your-api-key-here"

MCP Client Configuration

Add to your MCP client configuration (e.g., Claude Desktop):

{
  "mcpServers": {
    "neptime": {
      "command": "npx",
      "args": ["neptime-mcp-server"],
      "env": {
        "NEPTIME_API_KEY": "your-api-key-here"
      }
    }
  }
}

Or if installed globally:

{
  "mcpServers": {
    "neptime": {
      "command": "neptime-mcp-server",
      "env": {
        "NEPTIME_API_KEY": "your-api-key-here"
      }
    }
  }
}

Available Tools

Rate Limits

The Neptime API has the following rate limits:

• Global: 1000 requests/hour, 60 requests/minute
• Comments: 50/day, 10 seconds between posts
• Subscriptions: 50/day
• Reports: 10/hour, 50/day
• Playlists: 100 max per user, 500 videos per playlist

Development

# Clone the repository
git clone https://github.com/niceptime/neptime-mcp-server.git
cd neptime-mcp-server

# Install dependencies
npm install

# Build
npm run build

# Run in development mode
npm run dev

License

MIT