@hellocoop/admin-mcp (BETA)

Model Context Protocol (MCP) server for creating and managing Hellō applications.

🚧 BETA Status: This MCP server is currently in beta. We're actively seeking feedback and welcome contributions! Please report issues, suggest improvements, or submit pull requests to help us improve the developer experience.

Quick Install

📖 Full Documentation & Installation Guide

Quick Configuration

Copy one of these configurations into your MCP client settings:

NPM Package (Latest):

{
  "hello-admin-stdio": {
    "command": "npx",
            "args": ["-y", "@hellocoop/admin-mcp@latest"],
    "type": "stdio"
  }
}

HTTP Transport (Remote):

{
  "hello-admin-http": {
          "url": "https://admin-mcp.hello.coop/",
    "type": "http"
  }
}

📖 See Local Development Setup for running from source

Usage

This MCP server provides a single powerful tool (hello_manage_app) that lets you create and manage your Hellō applications directly from your AI assistant. Unlike traditional APIs, every operation automatically includes your complete developer context - profile, teams, and applications - making it perfect for AI assistants.

📖 For detailed usage instructions, examples, and troubleshooting, visit: hello.dev/docs/admin-mcp

Features

• 🏢 Context-Aware Operations: Every tool call automatically includes your current developer profile, teams, and applications for seamless context
• 📱 Unified Application Management: Single powerful tool for all app operations (create, read, update, secrets, logos)
• 🔐 Secure OAuth Integration: Browser-based authentication with JWT token validation
• 🌐 Multi-Transport Support: Works with both stdio (local) and HTTP (remote) MCP transports
• 📊 Built-in Analytics: Usage tracking and performance monitoring for optimization
• 🎨 Logo Management: Upload logos with automatic light/dark theme support
• ⚙️ Environment Flexibility: Configurable domains and admin servers

Available Tools

🎯 Core Tool:

• hello_manage_app - The main tool for all application management
  • Actions: create, read, update, create_secret, update_logo_from_data, update_logo_from_url
  • Always includes: Your current profile, teams, and applications in every response
  • Auto-context: Automatically uses your default team if none specified
  • Smart defaults: Generates app names from your profile if not provided

Key Benefits

🔄 Always In Context: Unlike traditional APIs, every tool response includes your complete developer context:

• Your user profile (name, email, picture)
• All your teams/organizations with roles
• All your applications with team associations
• Current team and application state

This means you never lose context between operations - perfect for AI assistants that need to understand your complete development environment.

Tool Actions & Response Structure

hello_manage_app Actions:

📝 create - Create new applications

• Auto-generates team if none exists
• Creates smart default names from your profile
• Returns: { profile, application, action_result }

👁️ read - Read application details

• Without client_id: Returns your complete profile context
• With client_id: Returns profile + specific application
• Returns: { profile, application?, action_result }

✏️ update - Update application settings

• Modify any application property
• Returns: { profile, application, action_result }

🔑 create_secret - Generate client secrets

• Creates secure OAuth client secrets
• Returns: { profile, application, client_secret, action_result }

🎨 update_logo_from_data - Upload logo from base64 data

• Supports light/dark themes
• Auto-updates application with logo URL
• Returns: `{ profile, application,

... View full README on GitHub