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

Tool	Description
neptime_list_videos	List videos with pagination and sorting
neptime_search_videos	Search for videos by keyword
neptime_trending_videos	Get trending videos
neptime_get_video	Get video details
neptime_update_video	Update a video you own
neptime_delete_video	Delete a video you own
neptime_rate_video	Like or dislike a video
neptime_get_channel	Get channel information
neptime_get_channel_videos	Get videos from a channel
neptime_subscribe	Subscribe to a channel
neptime_unsubscribe	Unsubscribe from a channel
neptime_get_subscriptions	Get your subscriptions
neptime_get_playlists	Get your playlists
neptime_get_playlist	Get playlist details
neptime_create_playlist	Create a new playlist
neptime_update_playlist	Update a playlist
neptime_delete_playlist	Delete a playlist
neptime_add_video_to_playlist	Add video to playlist
neptime_remove_video_from_playlist	Remove video from playlist
neptime_get_video_comments	Get comments on a video
neptime_create_video_comment	Post a comment
neptime_delete_comment	Delete your comment
neptime_rate_comment	Like or dislike a comment
neptime_list_articles	List articles
neptime_get_article	Get article details
neptime_create_article	Create an article
neptime_update_article	Update an article
neptime_delete_article	Delete an article
neptime_get_history	Get watch history
neptime_clear_history	Clear watch history
neptime_get_watch_later	Get watch later list
neptime_add_watch_later	Add to watch later
neptime_remove_watch_later	Remove from watch later
neptime_get_categories	Get all categories
neptime_get_category_videos	Get videos in a category
neptime_report_video	Report a video
neptime_init_chunked_upload	Initialize chunked upload session
neptime_upload_chunk	Upload a video chunk
neptime_complete_chunked_upload	Complete upload and create video
neptime_get_upload_status	Check upload progress

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