AXP axp.cat

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

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