Maverick MCPorter

Maverick-only OpenClaw code plugin for managing persisted MCPorter server configuration through a narrow Gateway RPC.

Registered RPC

The plugin registers:

maverick.mcporter.upsertServer
maverick.mcporter.deleteServer

Required scope:

operator.admin

The method writes to:

$HOME/.mcporter/mcporter.json

In the Maverick Cloudflare Container image, $HOME/.mcporter is symlinked into OpenClaw's persisted state directory, so changes survive R2 restore/sync.

Upsert Request Shape

{
  "serverId": "linear",
  "server": {
    "url": "https://mcp.linear.app/mcp",
    "transport": "streamable-http",
    "headers": {
      "Authorization": "$env:LINEAR_OAUTH_TOKEN"
    }
  }
}

transport defaults to streamable-http. The only allowed transports are streamable-http and sse.

Delete Request Shape

{
  "serverId": "linear"
}

Delete removes only the matching entry from mcpServers. It is idempotent: deleting a missing server or deleting when mcporter.json does not exist returns success with deleted: false.

Safety Boundaries

The plugin only accepts remote HTTPS MCP server definitions. It rejects local execution fields such as command, args, env, cwd, stdio, and path. It also rejects invalid server IDs, non-string headers, oversized header values, and prototype-pollution keys.

This plugin intentionally does not expose shell access and does not replace OpenClaw's built-in config RPCs.

Install

After publishing to ClawHub:

openclaw plugins install clawhub:maverick-mcporter@1.1.0

Restart the OpenClaw gateway after installation so the startup activation loads the plugin.

Test

npm test