English Français العربية

io.github.helloaigent-dev/helloaigent-publisher

Registre officiel Marketing et ventes

Run a Hello Aigent feed from your agent: create feeds, publish signed updates, read analytics.

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package @helloaigent-dev/publisher
Claude Code 
claude mcp add helloaigent-publisher -e 'HELLOAIGENT_ADMIN_TOKEN=<your helloaigent_admin_token>' -e 'HELLOAIGENT_TOKEN=<your helloaigent_token>' -e 'HELLOAIGENT_API=<HELLOAIGENT_API>' -- npx -y @helloaigent-dev/publisher@0.1.1
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "helloaigent-publisher": {
            "command": "npx",
            "args": [
                "-y",
                "@helloaigent-dev/publisher@0.1.1"
            ],
            "env": {
                "HELLOAIGENT_ADMIN_TOKEN": "<your helloaigent_admin_token>",
                "HELLOAIGENT_TOKEN": "<your helloaigent_token>",
                "HELLOAIGENT_API": "<HELLOAIGENT_API>"
            }
        }
    }
}

Variables d'environnement

  • HELLOAIGENT_ADMIN_TOKEN secret Admin token — required for feed management and analytics tools
  • HELLOAIGENT_TOKEN secret Publish token (a feed's publisher token); falls back to the admin token
  • HELLOAIGENT_API API base URL (default https://api.helloaigent.dev)

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

@helloaigent-dev/publisher

Hello Aigent publisher MCP — an MCP server that lets an agent run a publisher's feed: create feeds, publish signed updates, and read analytics. The producer-side counterpart to @helloaigent-dev/subscriber (which lets an agent subscribe/fetch/act).

A marketer operates their owned agent audience by telling their agent — no CLI, console, or developer.

Tools

ToolAuthWhat it does
hello_aigent_create_feedworkspace key or adminMint a feed + Ed25519 keypair + publisher token; returns the discovery file
hello_aigent_list_feedsworkspace key or adminList feeds you own
hello_aigent_publishpublish token, workspace key, or adminBuild + server-sign an update; delivered to subscribers
hello_aigent_report_eventpublish token, workspace key, or adminReport an action outcome (the "acted" analytics signal)
hello_aigent_overviewworkspace key or adminKPI tiles, fetch sparkline, recent activity
hello_aigent_funnelworkspace key or adminsubscribed → returned → acted funnel
hello_aigent_event_logworkspace key or adminFilterable, attributed audit log
hello_aigent_subscribersworkspace key or adminThe owned-audience list (consent-aware)
hello_aigent_discovery_filepublicGenerated hello-aigent.json to host at /.well-known/

"workspace key" means a hak_... workspace API key — mint one from the Hello Aigent console (Feeds → Give your agent access, or System → API keys) once you've signed up. It scopes every tool above to your own workspace: create_feed creates in your workspace, list_feeds/analytics/subscribers only ever see feeds your workspace owns, and publish/report_event only work on feeds your workspace owns. It is not admin-equivalent — it cannot create, list, or revoke API keys (that requires signing in to the console itself).

The admin token is a separate, unrestricted, ops-only credential (not something a self-serve signup ever receives) — it still works everywhere a workspace key does, for every feed, not just your own.

Configure

Set in your MCP client config (env vars):

  • HELLOAIGENT_API — API base (default https://api.helloaigent.dev)
  • HELLOAIGENT_API_KEY — your workspace API key (hak_...); required for feed management + analytics unless using the admin token. Preferred over HELLOAIGENT_ADMIN_TOKEN when both are set.
  • HELLOAIGENT_ADMIN_TOKEN — admin token; alternative to HELLOAIGENT_API_KEY (ops/dogfood use only)
  • HELLOAIGENT_TOKEN — publish token (a feed's own publisher token); falls back to HELLOAIGENT_API_KEY, then HELLOAIGENT_ADMIN_TOKEN

Example (Claude Desktop / any MCP client) — the common case, a self-serve workspace key:

{
  "mcpServers": {
    "hello-aigent-publisher": {
      "command": "npx",
      "args": ["-y", "@helloaigent-dev/publisher"],
      "env": { "HELLOAIGENT_API_KEY": "hak_…" }
    }
  }
}

Then just ask your agent: "Create a feed for my coffee shop and publish a restock update," or "How many agents subscribed this week, and what's the return rate?"

Questions fréquentes

Qu'est-ce que io.github.helloaigent-dev/helloaigent-publisher ?

Run a Hello Aigent feed from your agent: create feeds, publish signed updates, read analytics.

Comment installer io.github.helloaigent-dev/helloaigent-publisher ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add helloaigent-publisher -e 'HELLOAIGENT_ADMIN_TOKEN=<your helloaigent_admin_token>' -e 'HELLOAIGENT_TOKEN=<your helloaigent_token>' -e 'HELLOAIGENT_API=<HELLOAIGENT_API>' -- npx -y @helloaigent-dev/publisher@0.1.1. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.helloaigent-dev/helloaigent-publisher ?

Oui. Il attend HELLOAIGENT_ADMIN_TOKEN, HELLOAIGENT_TOKEN, à renseigner dans sa configuration.

io.github.helloaigent-dev/helloaigent-publisher est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient io.github.helloaigent-dev/helloaigent-publisher ?

Il est publié par helloaigent-dev. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.