Mentioned as a deployment option for hosting the MCP server
Provides access to Puch AI Discord community for support and help
Used for environment variable configuration including authentication tokens and phone numbers
Mentioned as a deployment option for hosting the MCP server
Provides HTTPS tunneling to expose local MCP server for external access by Puch AI
Runtime environment for the MCP server implementation
Mentioned as a deployment option for hosting the MCP server
Mentioned as a deployment option for hosting the MCP server
Integrates with Puch AI WhatsApp service for AI assistant interactions and phone number validation
MCP Starter for Puch AI
This is a starter template for creating your own Model Context Protocol (MCP) server that works with Puch AI. It comes with ready-to-use tools for job searching and image processing.
What is MCP?
MCP (Model Context Protocol) allows AI assistants like Puch to connect to external tools and data sources safely. Think of it like giving your AI extra superpowers without compromising security.
What's Included in This Starter?
🎯 Job Finder Tool
- Analyze job descriptions - Paste any job description and get smart insights
- Fetch job postings from URLs - Give a job posting link and get the full details
- Search for jobs - Use natural language to find relevant job opportunities
🖼️ Image Processing Tool
- Convert images to black & white - Upload any image and get a monochrome version
🔐 Built-in Authentication
- Bearer token authentication (required by Puch AI)
- Validation tool that returns your phone number
Quick Setup Guide
Step 1: Install Dependencies
First, make sure you have Python 3.11 or higher installed. Then:
Step 2: Set Up Environment Variables
Create a .env
file in the project root:
Then edit .env
and add your details:
Important Notes:
AUTH_TOKEN
: This is your secret token for authentication. Keep it safe!MY_NUMBER
: Your WhatsApp number in format{country_code}{number}
(e.g.,919876543210
for +91-9876543210)
Step 3: Run the Server
You'll see: 🚀 Starting MCP server on http://0.0.0.0:8086
Step 4: Make It Public (Required by Puch)
Since Puch needs to access your server over HTTPS, you need to expose your local server:
Option A: Using ngrok (Recommended)
- Install ngrok: Download from https://ngrok.com/download
- Get your authtoken:
- Go to https://dashboard.ngrok.com/get-started/your-authtoken
- Copy your authtoken
- Run:
ngrok config add-authtoken YOUR_AUTHTOKEN
- Start the tunnel:
Option B: Deploy to Cloud
You can also deploy this to services like:
- Railway
- Render
- Heroku
- DigitalOcean App Platform
How to Connect with Puch AI
- Open Puch AI in your browser
- Start a new conversation
- Use the connect command:
Debug Mode
To get more detailed error messages:
Customizing the Starter
Adding New Tools
- Create a new tool function:
- Add required imports if needed
📚 Additional Documentation Resources
Official Puch AI MCP Documentation
- Main Documentation: https://puch.ai/mcp
- Protocol Compatibility: Core MCP specification with Bearer & OAuth support
- Command Reference: Complete MCP command documentation
- Server Requirements: Tool registration, validation, HTTPS requirements
Technical Specifications
- JSON-RPC 2.0 Specification: https://www.jsonrpc.org/specification (for error handling)
- MCP Protocol: Core protocol messages, tool definitions, authentication
Supported vs Unsupported Features
✓ Supported:
- Core protocol messages
- Tool definitions and calls
- Authentication (Bearer & OAuth)
- Error handling
✗ Not Supported:
- Videos extension
- Resources extension
- Prompts extension
Getting Help
- Join Puch AI Discord: https://discord.gg/VMCnMvYx
- Check Puch AI MCP docs: https://puch.ai/mcp
- Puch WhatsApp Number: +91 99988 81729
Happy coding! 🚀
Use the hashtag #BuildWithPuch
in your posts about your MCP!
This starter makes it super easy to create your own MCP server for Puch AI. Just follow the setup steps and you'll be ready to extend Puch with your custom tools!
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
A starter template for creating MCP servers that work with Puch AI, including built-in tools for job searching (analyze descriptions, fetch postings, search opportunities) and basic image processing. Features bearer token authentication and ready-to-deploy setup for extending Puch AI with custom tools.
Related MCP Servers
- -securityAlicense-qualityA collection of custom MCP servers providing various AI-powered capabilities including web search, YouTube video analysis, GitHub repository analysis, reasoning, code generation/execution, and web crawling.Last updated -2PythonMIT License
- AsecurityFlicenseAqualityA starter template for building MCP servers that can integrate with Claude, Cursor, or other MCP-compatible AI assistants to create custom tools, resource providers, and prompt templates.Last updated -2JavaScript
- -securityAlicense-qualityA template MCP server that provides job searching tools (analyze descriptions, fetch postings, search opportunities) and basic image processing capabilities. Includes built-in authentication and is designed to work seamlessly with Puch AI.Last updated -26TypeScriptApache 2.0
- -securityAlicense-qualityA starter template for creating MCP servers that work with Puch AI, featuring built-in tools for job searching and image processing. Includes job description analysis, job posting fetching, job search capabilities, and image-to-grayscale conversion with bearer token authentication.Last updated -PythonApache 2.0