Neptime MCP 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