List videos from Neptime.io with pagination and sorting.

Args:

• limit: Max results 1-100 (default: 20)

• offset: Pagination offset (default: 0)

• sort: Sort order - newest, oldest, views, likes (default: newest)

• category: Filter by category ID (optional)

Returns: Array of video objects with id, title, views, likes, duration, thumbnail, channel info.

Search for videos on Neptime.io by keyword.

Args:

• q: Search query (required, 1-200 chars)

• limit: Max results 1-100 (default: 20)

• offset: Pagination offset (default: 0)

Returns: Array of matching videos with relevance scoring.

Get trending videos on Neptime.io.

Args:

• limit: Max results 1-100 (default: 20)

• period: Trending period - day, week, month (default: week)

Returns: Array of trending videos sorted by popularity.

Get detailed information about a specific video.

Args:

• video_id: Video ID (required)

Returns: Full video object with title, description, views, likes, comments count, channel, upload date, etc.

Update a video you own on Neptime.io.

Args:

• video_id: Video ID to update (required)

• title: New title (5-100 chars, optional)

• description: New description (max 5000 chars, optional)

• tags: Comma-separated tags (optional)

• privacy: public, private, or unlisted (optional)

Returns: Updated video object.

Delete a video you own on Neptime.io. This action is IRREVERSIBLE.

Args:

• video_id: Video ID to delete (required)

Returns: Confirmation of deletion.

Get channel information by ID.

Args:

• channel_id: Channel ID (required)

Returns: Channel object with name, avatar, subscriber count, video count, description.

Get videos from a specific channel.

Args:

• channel_id: Channel ID (required)

• limit: Max results 1-100 (default: 20)

• offset: Pagination offset (default: 0)

Returns: Array of videos from the channel.

Subscribe to a channel. Limit: 50 subscriptions per day.

Args:

• channel_id: Channel ID to subscribe to (required)

Returns: Subscription confirmation.

Unsubscribe from a channel.

Args:

• channel_id: Channel ID to unsubscribe from (required)

Returns: Unsubscription confirmation.

Get list of channels you are subscribed to.

Args:

• limit: Max results 1-100 (default: 20)

• offset: Pagination offset (default: 0)

Returns: Array of subscribed channels.

Get comments on a video.

Args:

• video_id: Video ID (required)

• limit: Max results 1-100 (default: 20)

• offset: Pagination offset (default: 0)

• sort: Sort order - newest, oldest, top (default: newest)

Returns: Array of comments with user info, text, likes, replies.

Get comments on an article.

Args:

• article_id: Article ID (required)

• limit: Max results 1-100 (default: 20)

• offset: Pagination offset (default: 0)

• sort: Sort order - newest, oldest, top (default: newest)

Returns: Array of comments with user info, text, likes, replies.

Post a comment on a video. Limit: 50 comments/day, 10s between posts.

Args:

• video_id: Video ID (required)

• text: Comment text, max 2000 chars (required)

Returns: Created comment object.

Post a comment on an article. Limit: 50 comments/day, 10s between posts.

Args:

• article_id: Article ID (required)

• text: Comment text, max 2000 chars (required)

Returns: Created comment object.

Delete a comment you own.

Args:

• comment_id: Comment ID to delete (required)

Returns: Deletion confirmation.

Like or dislike a comment.

Args:

• comment_id: Comment ID (required)

• rating: "like", "dislike", or "none" to remove rating (required)

Returns: Updated like/dislike counts.

Get all playlists owned by the authenticated user. Limit: 100 playlists max.

Returns: Array of playlist objects with id, name, video count, privacy.

Get details of a specific playlist including videos.

Args:

• list_id: Playlist ID (required)

Returns: Playlist object with videos array.

Create a new playlist. Limit: 100 playlists max per user.

Args:

• name: Playlist name, 2-100 chars (required)

• description: Description, max 500 chars (optional)

• privacy: public, private, or unlisted (default: private)

Returns: Created playlist object.

Update a playlist you own.

Args:

• list_id: Playlist ID (required)

• name: New name, 2-100 chars (optional)

• description: New description (optional)

• privacy: public, private, or unlisted (optional)

Returns: Updated playlist object.

Delete a playlist you own. This action is IRREVERSIBLE.

Args:

• list_id: Playlist ID to delete (required)

Returns: Deletion confirmation.

Add a video to a playlist. Limit: 500 videos per playlist.

Args:

• list_id: Playlist ID (required)

• video_id: Video ID to add (required)

Returns: Confirmation with updated video count.

Remove a video from a playlist.

Args:

• list_id: Playlist ID (required)

• video_id: Video ID to remove (required)

Returns: Confirmation with updated video count.

List articles/posts from Neptime.io.

Args:

• limit: Max results 1-100 (default: 20)

• offset: Pagination offset (default: 0)

Returns: Array of article objects with id, title, description, author, date.

Get a specific article by ID.

Args:

• article_id: Article ID (required)

Returns: Full article object with title, text, author, comments count.

Create a new article/post.

Args:

• title: Article title, 5-200 chars (required)

• description: Short description, 15-500 chars (required)

• text: Article body, min 50 chars (required)

• tags: Comma-separated tags (optional)

• category: Category ID (optional)

Returns: Created article object.

Update an article you own.

Args:

• article_id: Article ID (required)

• title: New title (optional)

• description: New description (optional)

• text: New body text (optional)

• tags: New tags (optional)

• category: New category ID (optional)

Returns: Updated article object.

Delete an article you own. This action is IRREVERSIBLE.

Args:

• article_id: Article ID to delete (required)

Returns: Deletion confirmation.

Get your video watch history.

Args:

• limit: Max results 1-100 (default: 20)

• offset: Pagination offset (default: 0)

Returns: Array of watched videos with timestamps.

Clear all watch history. This action is IRREVERSIBLE.

Returns: Confirmation of history cleared.

Get your watch later list.

Returns: Array of videos saved for later.

Add a video to your watch later list.

Args:

• video_id: Video ID to add (required)

Returns: Confirmation.

Remove a video from your watch later list.

Args:

• video_id: Video ID to remove (required)

Returns: Confirmation.

Get all video categories.

Returns: Array of category objects with id, name, video count.

Get videos in a specific category.

Args:

• category_id: Category ID (required)

• limit: Max results 1-100 (default: 20)

• offset: Pagination offset (default: 0)

Returns: Array of videos in the category.

Report a video for violating community guidelines. Limit: 10 reports/hour, 50/day.

Args:

• video_id: Video ID to report (required)

• reason: spam, harassment, hate_speech, violence, nudity, copyright, misinformation, or other (required)

• description: Additional details, max 500 chars (optional)

Returns: Report confirmation.

Like or dislike a video.

Args:

• video_id: Video ID (required)

• rating: "like", "dislike", or "none" to remove rating (required)

Returns: Updated like/dislike counts.

Upload a video to Neptime.io through the live /videos/upload endpoint.

Provide either video_path for a local file available to the MCP server, or video_base64 plus video_filename. Videos can be mp4, mov, webm, mpeg, avi, or mkv. The default privacy is private (1) for safety.

Args:

• title: Video title (required)

• description: Video description (required)

• tags: Comma-separated tags (required)

• video_path OR video_base64: Video file source (required)

• video_filename: Filename when using video_base64

• thumbnail_path OR thumbnail_base64: Optional thumbnail

• category_id: Optional category ID

• privacy: 0=public, 1=private, 2=unlisted (default: 1)

• age_restriction: 1=all ages, 2=18+ (default: 1)

• is_short: true for short-form video (default: false)

Returns: Uploaded video object with video_id, URL, stream URL, thumbnail, approval status, and privacy.