{"id":29604507,"url":"https://github.com/hellocoop/mcp","last_synced_at":"2025-07-20T15:37:26.777Z","repository":{"id":304869493,"uuid":"1019462775","full_name":"hellocoop/MCP","owner":"hellocoop","description":"Hellō Admin MCP Server","archived":false,"fork":false,"pushed_at":"2025-07-16T13:13:54.000Z","size":210,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-16T15:06:30.492Z","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-16T13:13:55.000Z","dependencies_parsed_at":"2025-07-16T21:12:37.338Z","dependency_job_id":"2c1c1d3b-1b86-4202-88b8-a6a075ad481a","html_url":"https://github.com/hellocoop/MCP","commit_stats":null,"previous_names":["hellocoop/mcp"],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/hellocoop/MCP","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hellocoop%2FMCP","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hellocoop%2FMCP/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hellocoop%2FMCP/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hellocoop%2FMCP/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hellocoop","download_url":"https://codeload.github.com/hellocoop/MCP/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hellocoop%2FMCP/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266151573,"owners_count":23884443,"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","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-20T15:37:23.620Z","updated_at":"2025-07-20T15:37:26.769Z","avatar_url":"https://github.com/hellocoop.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# @hellocoop/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**Stdio Transport (Local):**\n```json\n{\n  \"hello-admin-stdio\": {\n    \"command\": \"npx\",\n    \"args\": [\"-y\", \"@hellocoop/mcp@latest\"],\n    \"type\": \"stdio\",\n    \"env\": {\n      \"HELLO_DOMAIN\": \"hello-beta.net\"\n    }\n  }\n}\n```\n\n**streamableHTTP Transport (Remote):**\n```json\n{\n  \"hello-admin-http\": {\n    \"url\": \"https://mcp.hello-beta.net/\",\n    \"type\": \"http\"\n  }\n}\n```\n\n## Usage\n\nThis MCP server lets you create and manage your Hellō applications directly from your AI assistant instead of using the [Hellō Console](https://console.hello.coop).\n\n**📖 For detailed usage instructions, examples, and troubleshooting, visit: [hello.dev/docs/mcp](https://hello.dev/docs/mcp)**\n\n## Features\n\n- **Application Management**: Create, read, and update Hellō applications\n- **Publisher Management**: Create and manage publishers (teams/organizations)\n- **OAuth Integration**: Secure authentication via browser-based OAuth flow\n- **Legal Document Generation**: Create Terms of Service and Privacy Policy templates\n- **Logo Management**: Upload and manage application logos\n- **Multiple Transports**: Both stdio and HTTP MCP transports supported\n- **Environment Flexibility**: Configurable domains and admin servers\n\n## Available Tools\n\n- `hello_get_profile` - Get your developer profile and publishers\n- `hello_create_publisher` - Create a new publisher (team/organization)\n- `hello_read_publisher` - Read detailed publisher information\n- `hello_create_application` - Create a new Hellō application\n- `hello_read_application` - Read detailed application information\n- `hello_update_application` - Update application settings\n- `hello_upload_logo` - Upload application logos\n- `hello_create_secret` - Create client secrets for applications\n- `hello_generate_login_button` - Generate HTML/JavaScript login buttons\n- `hello_generate_legal_docs` - Generate Terms of Service and Privacy Policy templates\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/packages-js\ncd packages-js/MCP\n\n# Install dependencies\nnpm install\n\n# Run in stdio mode\nnpm start\n\n# Run HTTP server mode\nnpm run start:http\n```\n\n### Getting Access Tokens for Testing\n\nThe `get-token` script performs OAuth flow and outputs token data as JSON:\n\n```sh\n# Get complete token response\nnpm run get-token\n\n# Extract just the access token\nnpm run get-token | jq -r '.access_token'\n\n# Use in shell commands\nTOKEN=$(npm run get-token 2\u003e/dev/null | jq -r '.access_token')\ncurl -H \"Authorization: Bearer $TOKEN\" https://admin.hello.coop/api/v1/profile\n\n# Save to file for reuse\nnpm run get-token \u003e token.json\n```\n\n### Testing\n\nRun the comprehensive test suite:\n\n```sh\n# Run all automated tests\nnpm test\n\n# Run interactive OAuth test\nnpm run test:oauth-interactive\n```\n\n### Docker Development\n\nBuild and test locally:\n\n```sh\n# Build local Docker image\nnpm run docker:build-local\n\n# Run locally built image\ndocker run -p 3000:3000 hellocoop/mcp:local\n```\n\n### Publishing\n\nFor maintainers publishing to Docker Hub:\n\n```sh\nnpm run docker:publish\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhellocoop%2Fmcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhellocoop%2Fmcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhellocoop%2Fmcp/lists"}