Neptime Server

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

Features

This MCP server provides 39 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

• Upload videos through Neptime.io's live multipart upload endpoint
• Supports local file paths or base64-encoded video bytes
• Optional thumbnail, category, privacy, age restriction, and short-form flags

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
• Get and post article comments when supported by the Neptime API
• 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_get_article_comments	Get comments on an article
neptime_create_video_comment	Post a video comment
neptime_create_article_comment	Post an article 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_upload_video	Upload a video using a local path or base64 payload

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/pasie15/neptime-mcp-server.git
cd neptime-mcp-server

# Install dependencies
npm install

# Build
npm run build

# Unit tests
npm test

# Run in development mode
npm run dev

License

MIT