{
  "markdown": "# @hellocoop/admin-mcp (BETA)\n\nModel Context Protocol (MCP) server for creating and managing [Hellō](https://hello.dev) applications.\n\n> **🚧 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.\n\n## Quick Install\n\n📖 **[Full Documentation & Installation Guide](https://hello.dev/docs/admin-mcp)**\n\n### Quick Configuration\n\nCopy one of these configurations into your MCP client settings:\n\n**NPM Package (Latest):**\n```json\n{\n  \"hello-admin-stdio\": {\n    \"command\": \"npx\",\n            \"args\": [\"-y\", \"@hellocoop/admin-mcp@latest\"],\n    \"type\": \"stdio\"\n  }\n}\n```\n\n**HTTP Transport (Remote):**\n```json\n{\n  \"hello-admin-http\": {\n          \"url\": \"https://admin-mcp.hello.coop/\",\n    \"type\": \"http\"\n  }\n}\n```\n\n📖 **[See Local Development Setup](#local-development)** for running from source \n\n## Usage\n\nThis 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.\n\n**📖 For detailed usage instructions, examples, and troubleshooting, visit: [hello.dev/docs/admin-mcp](https://hello.dev/docs/admin-mcp)**\n\n## Features\n\n- **🏢 Context-Aware Operations**: Every tool call automatically includes your current developer profile, teams, and applications for seamless context\n- **📱 Unified Application Management**: Single powerful tool for all app operations (create, read, update, secrets, logos)\n- **🔐 Secure OAuth Integration**: Browser-based authentication with JWT token validation\n- **🌐 Multi-Transport Support**: Works with both stdio (local) and HTTP (remote) MCP transports\n- **📊 Built-in Analytics**: Usage tracking and performance monitoring for optimization\n- **🎨 Logo Management**: Upload logos with automatic light/dark theme support\n- **⚙️ Environment Flexibility**: Configurable domains and admin servers\n\n## Available Tools\n\n**🎯 Core Tool:**\n- `hello_manage_app` - **The main tool for all application management**\n  - **Actions**: `create`, `read`, `update`, `create_secret`, `update_logo_from_data`, `update_logo_from_url`\n  - **Always includes**: Your current profile, teams, and applications in every response\n  - **Auto-context**: Automatically uses your default team if none specified\n  - **Smart defaults**: Generates app names from your profile if not provided\n\n## Key Benefits\n\n**🔄 Always In Context**: Unlike traditional APIs, every tool response includes your complete developer context:\n- Your user profile (name, email, picture)\n- All your teams/organizations with roles\n- All your applications with team associations\n- Current team and application state\n\nThis means you never lose context between operations - perfect for AI assistants that need to understand your complete development environment.\n\n## Tool Actions & Response Structure\n\n### `hello_manage_app` Actions:\n\n**📝 `create`** - Create new applications\n- Auto-generates team if none exists\n- Creates smart default names from your profile\n- Returns: `{ profile, application, action_result }`\n\n**👁️ `read`** - Read application details  \n- Without `client_id`: Returns your complete profile context\n- With `client_id`: Returns profile + specific application\n- Returns: `{ profile, application?, action_result }`\n\n**✏️ `update`** - Update application settings\n- Modify any application property\n- Returns: `{ profile, application, action_result }`\n\n**🔑 `create_secret`** - Generate client secrets\n- Creates secure OAuth client secrets\n- Returns: `{ profile, application, client_secret, action_result }`\n\n**🎨 `update_logo_from_data`** - Upload logo from base64 data\n- Supports light/dark themes\n- Auto-updates application with logo URL\n- Returns: `{ profile, application, update_result, action_result }`\n\n**🔗 `update_logo_from_url`** - Upload logo from URL\n- Fetches and uploads from provided URL\n- Supports light/dark themes  \n- Returns: `{ profile, application, update_result, action_result }`\n\n**Every response includes your complete profile context**, making it perfect for AI assistants that need to maintain awareness of your development environment.\n\n## Available Resources\n\n- **Hellō Documentation** - Complete integration documentation\n- **Hellō Quickstarts** - Framework-specific setup guides\n- **Hellō Buttons** - Login button implementation guide\n- **Hellō Scopes** - Available scopes and claims reference\n- **Hellō Wallet API** - Wallet API reference documentation\n- **Hellō Logo Design Guidance** - Comprehensive guide for creating theme-appropriate logos\n\n## Environment Variables\n\n- `HELLO_DOMAIN`: Override the default domain (defaults to `hello.coop`)\n- `HELLO_ADMIN`: Override the admin server URL (defaults to `https://admin.hello.coop`)\n\n## Contributing & Development\n\n**We want your feedback!** This MCP server is in beta and we're actively improving it based on real-world usage.\n\n### How to Contribute\n\n- **🐛 Report Issues**: [GitHub Issues](https://github.com/hellocoop/packages-js/issues) - Found a bug or have a feature request?\n- **🔧 Submit Pull Requests**: [GitHub PRs](https://github.com/hellocoop/packages-js/pulls) - Help us improve the server\n- **💬 Join the Discussion**: [Discord](https://discord.gg/hellocoop) - Share feedback and get help\n\n### Local Development\n\nFor local development and testing:\n\n```sh\n# Clone the repository\ngit clone https://github.com/hellocoop/admin-mcp\ncd admin-mcp\n\n# Install dependencies\nnpm install\n```\n\nThe configure your AI client to run the local version \n\n**Local Development (Node.js):**\n```json\n{\n  \"hello-admin-local\": {\n    \"command\": \"node\",\n            \"args\": [\"path/to/HelloCoop/admin-mcp/src/stdio.js\"],\n    \"type\": \"stdio\"\n  }\n}\n```\n\n### Testing\n\nRun the comprehensive test suite:\n\n```sh\n# Run all automated tests\nnpm test\n\n```\n",
  "bytes": 6038,
  "sha": "b620c9703a88fa330ee7b864ded7810a0733cd174d54974190d30bf8d5c64523",
  "repo_slug": "hellocoop/admin-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_hellocoop_admin_mcp_fa7a57e2/readme"
}