Admin MCP Server (BETA)

The Admin MCP server lets you create and manage your Hellō applications directly from your AI assistant,
including uploading logos for both light and dark themes.

⚠️

This MCP server is currently in BETA. Help us improve the server by filing issues or making suggestions (opens in a new tab).

Installing

Cursor

Manual Install:
Cursor Settings → MCP → Add new MCP Server. Use type http and URL https://admin-mcp.hello.coop/.
See Cursor guide (opens in a new tab) for more information.

VSCode

Manual Install:

code --add-mcp '{"name":"Hellō Admin","url":"https://admin-mcp.hello.coop","type":"http"}'

See VS Code guide (opens in a new tab) for more information.

Claude Code

Using the Claude CLI:

claude mcp add hello-admin http https://admin-mcp.hello.coop/

See Claude guide (opens in a new tab) for more information.

Claude Desktop

Manual Install:
Navigate to Connector Settings → Add a Custom Connector → Paste the HTTP Transport config.
See Claude Desktop Guide (opens in a new tab) for more information.

Gemini CLI

Manual Install:
Create .gemini/settings.json in your project's root directory → Add mcpServers block → Paste the HTTP Transport config.
See Gemini CLI Guide (opens in a new tab) for more information.

Goose

Manual Install:
Advanced settings → Extensions → Add custom extension and paste the HTTP Transport config.
See Example guide (opens in a new tab) for more information.

LM Studio

Manual Install:
Program → Install → Edit mcp.json and paste the HTTP Transport config.
See LM Studio (opens in a new tab) for more information.

Qodo Gen

Manual Install:
Open the chat panel → Connect more tools → Add new MCP → Paste the Stdio Transport config config.
See Qodo Gen (opens in a new tab) for more information.

Don’t see your tool listed? File an issue (opens in a new tab) and we’ll add support.

Manual

From Source:
Clone the repo and follow the instructions at hellocoop/admin-mcp (opens in a new tab).

HTTP Transport (Remote - Recommended):

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

NPM Package (Local - Most compatible):

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

Features

`hello_manage_app`

This is the primary tool for managing Hellō applications.

Supported actions:

create – Create new applications with smart defaults
read – Retrieve application or profile details
update – Update app settings (redirect URIs, names, etc.)
create_secret – Generate OAuth client secrets
update_logo_from_data – Upload a logo using base64 data
update_logo_from_url – Upload a logo via public URL

Each response includes:

Your user profile (name, email, picture)
Your teams and organizations, along with assigned roles
All apps associated with your teams
Current team and app state

Authentication

This MCP server uses OAuth 2.1 for secure authentication:

OAuth Flow: When you first use the tool, the server opens your browser
Login: Complete the login process with your Hellō account
Token: The server receives a 1-hour access token
Context: All API calls return your complete developer context

Security & Limitations

Security:

OAuth 2.1 industry-standard authentication
Short-lived tokens (1-hour expiration)
HTTPS-only API communication
Access scoped to create, read, update. Deletion actions are intentionally restricted.

Current Limitations:

Cannot delete applications (use Hellō Console (opens in a new tab) for deletion)
Token requires re-authentication after 1 hour of inactivity

Troubleshooting

Common Issues

"npx command not found" error:

Install Node.js 18+ from nodejs.org (opens in a new tab)
Verify installation: node --version and npm --version
On macOS/Linux, you may need to restart your terminal after installation

"MCP server not found" error:

Ensure your MCP client supports the transport type (HTTP or stdio)
Check that the server URL or command is correctly configured
Verify network connectivity for HTTP transport

"Authentication required" errors:

The server will automatically prompt for login when needed
Make sure you complete the browser-based OAuth flow

"Application not found" errors:

Use hello_manage_app with action: "read" to see your applications
Make sure you're using the correct client_id

Logo upload issues:

Ensure logo_content_type matches your image format
Supported formats: PNG, JPEG, GIF, WebP, APNG, SVG
Keep file sizes under 100KB for best performance

Getting Help & Contributing

We want your feedback! This MCP server is in beta and we're actively improving it.

Documentation: MCP Server Repository (opens in a new tab)
Report Issues: GitHub Issues (opens in a new tab)
Contribute: Submit Pull Requests (opens in a new tab)
Community: Join our Slack Community (opens in a new tab)

For local development, testing, and advanced usage, visit the Admin MCP Server GitHub repo (opens in a new tab).

Hellō Mockin Hellō vs ___