Catalog / mintbot.ai / mintbot-mcp
mintbot MCP server 0.1.1 beta
An MCP server on the agent's own VPS: chat with the agent and manage every mintbot setting (model, persona, name, credit, jobs, extensions, Telegram bot, updates, SSH keys, two-factor) from any MCP client such as Claude Desktop, Claude Code or Cursor. No central server involved; loopback only, bearer-authenticated.
Install
Hand this locator to your AXP host (on mintbot: tell your agent "install github.com/mintbot-ai/mintbot-mcp"):
https://github.com/mintbot-ai/mintbot-mcp
- Extension id
mintbot.ai/mintbot-mcp- Publisher
- mintbot.ai
- Homepage
- https://github.com/mintbot-ai/mintbot-mcp
- Licence
- MIT
- Keywords
- mcp, model-context-protocol, mintbot, hermes, remote-control
- Runtimes
- hermes
- Provides
- services
- Published
- 2026-09-26T12:26:47Z
- Valid until
- 2027-03-25T12:26:47Z
- Manifest
- https://github.com/mintbot-ai/mintbot-mcp/releases/download/v0.1.1/agent-extension.json (release-listing)
- Signing key
ed25519:MGWTLv6h0j5d3mUnWZc0MzwZkhJQcmYVkJUMSLCXFno=key_id mintbot.ai-mintbot-mcp-2026
bound to the publisher via the publisher key directory- Listed
- 2026-10-14T23:27:16Z · last checked 2026-10-14T23:41:26Z
Declared permissions
- network egress
pypi.org:443,files.pythonhosted.org:443,api.mintbot.ai:443,api.mintbot.dev:443
install.sh pip-installs the pinned dependencies (mcp, httpx, uvicorn, pyyaml) into a private virtualenv under the install prefix (PyPI); at runtime only the display name, the credit balance and the model catalog are read from the mintbot API, exactly as the agent's own tools do.- network ingress
127.0.0.1:8650/tcp
The MCP endpoint itself: HTTP on 127.0.0.1:8650, never on a public interface, every request except /health must carry the bearer token created at install.- filesystem
config:r,state:rw
config:r = the Hermes home is read for the API server key and the mintbot block of config.yaml (agent id, panel token); state:rw = the bearer token (mode 0600) lives in the extension state dir. Settings are changed through the panel-local daemon on loopback, never by editing files.- root
- no
Components
services
mcp- Streamable-HTTP MCP server on loopback (bearer-authenticated): chat with the agent and read or change every mintbot setting.
Manifest as admitted
{
"identity": {
"author": "mintbot.ai",
"description": "An MCP server on the agent's own VPS: chat with the agent and manage every mintbot setting (model, persona, name, credit, jobs, extensions, Telegram bot, updates, SSH keys, two-factor) from any MCP client such as Claude Desktop, Claude Code or Cursor. No central server involved; loopback only, bearer-authenticated.",
"display_name": "mintbot MCP server",
"homepage": "https://github.com/mintbot-ai/mintbot-mcp",
"keywords": [
"mcp",
"model-context-protocol",
"mintbot",
"hermes",
"remote-control"
],
"license": "MIT",
"name": "mintbot-mcp",
"publisher": "mintbot.ai",
"version": "0.1.1"
},
"kind": "agent-extension",
"permissions": {
"filesystem": [
"config:r",
"state:rw"
],
"network_egress": [
"pypi.org:443",
"files.pythonhosted.org:443",
"api.mintbot.ai:443",
"api.mintbot.dev:443"
],
"network_ingress": [
"127.0.0.1:8650/tcp"
],
"reason": {
"filesystem": "config:r = the Hermes home is read for the API server key and the mintbot block of config.yaml (agent id, panel token); state:rw = the bearer token (mode 0600) lives in the extension state dir. Settings are changed through the panel-local daemon on loopback, never by editing files.",
"network_egress": "install.sh pip-installs the pinned dependencies (mcp, httpx, uvicorn, pyyaml) into a private virtualenv under the install prefix (PyPI); at runtime only the display name, the credit balance and the model catalog are read from the mintbot API, exactly as the agent's own tools do.",
"network_ingress": "The MCP endpoint itself: HTTP on 127.0.0.1:8650, never on a public interface, every request except /health must carry the bearer token created at install.",
"runtime": "Chat turns go to the Hermes API server on loopback and run as the agent's own turns (same model, same credit); the daemon holds no LLM credentials of its own."
},
"root": false
},
"provides": {
"services": [
{
"auth": {
"scheme": "bearer",
"token_file": "state:token"
},
"endpoint": "http://127.0.0.1:8650/mcp",
"kind": "daemon",
"name": "mcp",
"summary": "Streamable-HTTP MCP server on loopback (bearer-authenticated): chat with the agent and read or change every mintbot setting."
}
]
},
"release": {
"artifact": {
"sha256": "cc974bf36a2ead798f6ecc4076876d467215d3cfec582ab091e32059d90d079c",
"url": "https://github.com/mintbot-ai/mintbot-mcp/releases/download/v0.1.1/mintbot-mcp-0.1.1.tar.gz"
},
"changelog": "https://github.com/mintbot-ai/mintbot-mcp/releases/tag/v0.1.0",
"channel": "beta",
"published_at": "2026-09-26T12:26:47Z",
"valid_until": "2027-03-25T12:26:47Z"
},
"requires": {
"resources": {
"disk_mb": 80,
"ram_mb": 128
}
},
"signature": "+X9l19xQC/K2kCEBNfPLNlbLa/7J9JoQf7j6T6sCLaybW5oCV3nMq8YYvU2eWvfHq1dT9sIadeBpW1NnCEqqAA==",
"signing": {
"key_id": "mintbot.ai-mintbot-mcp-2026",
"next_key": null,
"public_key": "ed25519:MGWTLv6h0j5d3mUnWZc0MzwZkhJQcmYVkJUMSLCXFno="
},
"spec_version": "0.4",
"targets": [
{
"component_map": {
"services": {
"command": [
"bin/mintbot-mcp",
"serve"
],
"health": "http://127.0.0.1:8650/health",
"restart": "always"
}
},
"delivery": {
"method": "archive",
"sha256": "cc974bf36a2ead798f6ecc4076876d467215d3cfec582ab091e32059d90d079c",
"url": "https://github.com/mintbot-ai/mintbot-mcp/releases/download/v0.1.1/mintbot-mcp-0.1.1.tar.gz"
},
"enforcement": "advisory",
"lifecycle": {
"health": "healthcheck.sh",
"install": "install.sh",
"uninstall": "uninstall.sh",
"upgrade": "upgrade.sh"
},
"platforms": [
"linux/amd64",
"linux/arm64"
],
"runtime": "hermes",
"runtime_version": ">=0.18.2"
}
],
"updates": {
"check": "daily",
"policy": "notify",
"source": {
"kind": "github",
"repo": "mintbot-ai/mintbot-mcp"
}
}
}
Machine-readable: /api/catalog/mintbot.ai/mintbot-mcp.json