Skip to main content
Glama

Puch AI MCP Starter

by VipulGhodke

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:

# Create virtual environment uv venv # Install all required packages uv sync # Activate the environment source .venv/bin/activate

Step 2: Set Up Environment Variables

Create a .env file in the project root:

# Copy the example file cp .env.example .env

Then edit .env and add your details:

AUTH_TOKEN=your_secret_token_here MY_NUMBER=919876543210

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

cd mcp-bearer-token python mcp_starter.py

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:

  1. Install ngrok: Download from https://ngrok.com/download
  2. Get your authtoken:
    • Go to https://dashboard.ngrok.com/get-started/your-authtoken
    • Copy your authtoken
    • Run: ngrok config add-authtoken YOUR_AUTHTOKEN
  3. Start the tunnel:
    ngrok http 8086
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

  1. Open Puch AI in your browser
  2. Start a new conversation
  3. Use the connect command:
    /mcp connect https://your-domain.ngrok.app/mcp your_secret_token_here

Debug Mode

To get more detailed error messages:

/mcp diagnostics-level debug

Customizing the Starter

Adding New Tools

  1. Create a new tool function:
    @mcp.tool(description="Your tool description") async def your_tool_name( parameter: Annotated[str, Field(description="Parameter description")] ) -> str: # Your tool logic here return "Tool result"
  2. 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!

-
security - not tested
A
license - permissive license
-
quality - not tested

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, 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.

  1. What is MCP?
    1. What's Included in This Starter?
      1. 🎯 Job Finder Tool
      2. 🖼️ Image Processing Tool
      3. 🔐 Built-in Authentication
    2. Quick Setup Guide
      1. Step 1: Install Dependencies
      2. Step 2: Set Up Environment Variables
      3. Step 3: Run the Server
      4. Step 4: Make It Public (Required by Puch)
    3. How to Connect with Puch AI
      1. Debug Mode
    4. Customizing the Starter
      1. Adding New Tools
    5. 📚 Additional Documentation Resources
      1. Official Puch AI MCP Documentation
      2. Technical Specifications
      3. Supported vs Unsupported Features
    6. Getting Help

      Related MCP Servers

      • -
        security
        A
        license
        -
        quality
        An MCP server implementation that standardizes how AI applications access tools and context, providing a central hub that manages tool discovery, execution, and context management with a simplified configuration system.
        Last updated -
        12
        Python
        MIT License
      • -
        security
        A
        license
        -
        quality
        A 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 -
        2
        Python
        MIT License
      • A
        security
        A
        license
        A
        quality
        An MCP server that enables AI applications to access 20+ model providers (including OpenAI, Anthropic, Google) through a unified interface for text and image generation.
        Last updated -
        2
        12
        Python
        MIT License
      • -
        security
        A
        license
        -
        quality
        An MCP server that enables AI assistants like Claude Desktop to search and retrieve information from custom search indexes created with Searchcraft.
        Last updated -
        5
        TypeScript
        Apache 2.0

      View all related MCP servers

      MCP directory API

      We provide all the information about MCP servers via our MCP API.

      curl -X GET 'https://glama.ai/api/mcp/v1/servers/VipulGhodke/mcpServer'

      If you have feedback or need assistance with the MCP directory API, please join our Discord server