What is Kickmcp

KickMCP is a secure, standardized Model Context Protocol (MCP) server designed for the Kick streaming platform API, providing a robust interface for third-party applications to integrate with Kick’s services.

Use cases

Use cases for KickMCP include building applications that require user authentication and profile management, managing user subscriptions for streaming services, and implementing real-time communication features in applications.

How to use

To use KickMCP, clone the repository, install the dependencies, configure your environment variables with your Kick API credentials, and start the server using npm commands.

Key features

Key features of KickMCP include secure OAuth 2.0 authentication, user profile management, subscription handling, WebSocket-based real-time communication, built-in security best practices, automatic reconnection handling, comprehensive error handling, and serverless deployment readiness.

Where to use

KickMCP can be used in various fields such as streaming services, application development for social platforms, and any third-party integrations requiring secure API access.

🎮 KickMCP - Kick API Integration Made Easy

🚀 A powerful Model Context Protocol (MCP) server for seamless Kick.com API integration

📋 Table of Contents

• Quick Start
• Features
• User Guides
  • For Viewers
  • For Streamers
  • For Developers
• Installation
• Authentication Setup
• API Documentation
• Troubleshooting
• Contributing
• License

🚀 Quick Start

1. Install the package:

npm install kick-mcp

2. Create your MCP configuration (mcp.json):

3. Get your credentials:

• Visit Kick Developer Settings to obtain your Client ID
• Get your Smithery key from Smithery.ai

✨ Features

• Complete Kick API Integration:

  • Authentication (OAuth, App Access Tokens)
  • Chat messaging with reply support
  • Channel information by ID and slug
  • User profile management
  • Stream control (start/stop/update)
  • Polls and predictions
  • Livestream status webhooks
  • Category search and trending content

• MCP Standard Compliance:

  • JSON-RPC 2.0 interface
  • Standardized authentication
  • Extensible endpoints
  • AI assistant compatibility

• Developer Experience:

  • Modern TypeScript codebase
  • Comprehensive documentation
  • Built-in diagnostics
  • Consistent error handling

👥 User Guides

👀 For Viewers

Enhance your viewing experience with KickMCP:

• Chat Integration: Build custom chat clients with real-time message support
• Channel Notifications: Get alerts when your favorite streamers go live
• Content Discovery: Find new channels and trending categories

Example: Setting up chat notifications

const kickmcp = require('kick-mcp');

kickmcp.on('chatMessage', (message) => {
  if (message.mentions.includes(yourUsername)) {
    sendNotification(`${message.sender} mentioned you!`);
  }
});

🎥 For Streamers

Optimize your streaming workflow:

• Stream Management: Control your stream settings programmatically
• Chat Moderation: Build custom moderation tools
• Analytics: Track viewer engagement and channel growth
• Polls & Predictions: Create interactive content

Example: Creating a poll

const poll = await kickmcp.createPoll({
  question: "What game next?",
  options: ["Minecraft", "Fortnite", "Valorant"],
  duration: 300 // 5 minutes
});

💻 For Developers

Build powerful Kick.com integrations:

• OAuth Authentication: Secure user authentication flow
• Webhooks: Real-time event processing
• RESTful API: Complete API coverage
• TypeScript Support: Full type definitions

Example: Setting up webhooks

const webhook = await kickmcp.createWebhook({
  events: ['stream.online', 'stream.offline'],
  url: 'https://your-server.com/webhook'
});

🔧 Installation

npm install kick-mcp

# or with yarn
yarn add kick-mcp

🔑 Authentication Setup

1. Visit Kick Developer Settings
2. Create a new application
3. Copy your Client ID and Client Secret
4. Configure your MCP server:

const kickmcp = require('kick-mcp');

kickmcp.configure({
  clientId: 'YOUR_CLIENT_ID',
  clientSecret: 'YOUR_CLIENT_SECRET'
});

📚 API Documentation

For detailed API documentation, visit:

• Kick API Documentation
• KickMCP TypeDoc

🔍 Troubleshooting

Common issues and solutions:

1. Authentication Errors

   • Verify your Client ID and Secret
   • Check your OAuth redirect URI
   • Ensure your Smithery key is valid

2. Rate Limiting

   • Implement proper request throttling
   • Use caching where appropriate
   • Monitor your API usage

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

📄 License

MIT © NosytLabs