Postroom agent integration package

Development package 0.1.0. Host-specific authenticated acceptance tests are pending. This repository is not evidence of Hermes catalog approval, Gemini app approval or ClawHub publication. Postroom is a product by Not a Company Name Yet, operated by Vardhiva Innovations.

Hermes Agent

Portable Agent Plugins v1 package: plugin.json, mcp.json and skills. The legacy optional-mcps catalog is closed to new entries; public proposals must use plugin-catalog after validation.

Install and explicitly enable:

hermes plugins install notacompanynameyet/postroom-agent-plugin --no-enable
hermes plugins enable postroom

Portable MCP configuration alone does not enable OAuth. Merge the following native server definition into the active profile's existing config; do not replace other settings:

mcp_servers:
  postroom:
    url: https://social.notacompanynameyet.com/mcp
    auth: oauth
    oauth:
      scope: "social.read social.write"
    trust: untrusted

hermes mcp login postroom
hermes chat

Hermes owns sign-in, token storage and refresh. Native configuration takes precedence, so keep its untrusted approval gate too. Before catalog submission, run the full validator at the exact proposed commit:

hermes plugins validate /path/to/postroom-agent-plugin --install-deps

The full validator and fresh Hermes OAuth test have not yet been run. Do not describe this as a Nous-approved catalog plugin.

Gemini CLI

This is separate from the Gemini app / Search Connected Apps program and does not implement A2A.

gemini extensions install https://github.com/notacompanynameyet/postroom-agent-plugin
gemini

Inside the CLI:

/mcp auth postroom
/mcp list

The root manifest uses Streamable HTTP and native OAuth discovery/DCR. No API key is embedded. Preserve normal approval prompts. The extension is prepared for testing. Add the gemini-cli-extension discovery topic only after host OAuth/tool tests succeed; gallery validation and listing are not asserted.

OpenClaw / ClawHub

Publishable skill folder: openclaw/postroom. It documents native OAuth MCP setup.

clawhub login
clawhub whoami
clawhub skill publish ./openclaw/postroom --slug postroom --name "Postroom" --version 1.0.0

Verify the publisher owner and registry scan result. No successful ClawHub upload is asserted.

Behaviour and disclosures

Every tool call goes to https://social.notacompanynameyet.com/mcp, as the user's own Postroom workspace.
Requested account, brand, post, media and analytics results enter the host session and may reach its model provider.
The hosted tool list can change independently of this package's pinned source.
Writes can change publishing queues and publish to connected accounts. Show the exact immutable preview and obtain explicit approval first. A connection grant is not post approval.
Inspect status after uncertain writes; never create another draft as an automatic retry.
TikTok in this MCP uses inbox upload and requires completion in TikTok. Availability depends on provider permissions.
No local executables, install scripts, background processes, credential readers or added telemetry are bundled.
Postroom terms, privacy policy, allowances and provider limits apply. This package grants no billing bypass.

postroom

README