{"id":29824268,"url":"https://github.com/hellocoop/admin-mcp","last_synced_at":"2025-07-29T02:43:17.034Z","repository":{"id":304869493,"uuid":"1019462775","full_name":"hellocoop/admin-mcp","owner":"hellocoop","description":"Hellō Admin MCP Server","archived":false,"fork":false,"pushed_at":"2025-07-25T20:04:51.000Z","size":483,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-25T20:08:46.363Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hellocoop.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-14T11:10:22.000Z","updated_at":"2025-07-25T17:34:13.000Z","dependencies_parsed_at":"2025-07-16T21:12:37.338Z","dependency_job_id":"2c1c1d3b-1b86-4202-88b8-a6a075ad481a","html_url":"https://github.com/hellocoop/admin-mcp","commit_stats":null,"previous_names":["hellocoop/mcp","hellocoop/admin-mcp"],"tags_count":28,"template":false,"template_full_name":null,"purl":"pkg:github/hellocoop/admin-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hellocoop%2Fadmin-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hellocoop%2Fadmin-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hellocoop%2Fadmin-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hellocoop%2Fadmin-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hellocoop","download_url":"https://codeload.github.com/hellocoop/admin-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hellocoop%2Fadmin-mcp/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267620977,"owners_count":24116882,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-29T02:00:12.549Z","response_time":2574,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-07-29T02:43:01.544Z","updated_at":"2025-07-29T02:43:17.020Z","avatar_url":"https://github.com/hellocoop.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# @hellocoop/admin-mcp (BETA)\n\nModel Context Protocol (MCP) server for creating and managing [Hellō](https://hello.dev) applications.\n\n\u003e **🚧 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 \u0026 Installation Guide](https://hello.dev/docs/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/mcp](https://hello.dev/docs/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 \u0026 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 \u0026 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","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhellocoop%2Fadmin-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhellocoop%2Fadmin-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhellocoop%2Fadmin-mcp/lists"}