helloaigent-publisher

# @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`](https://www.npmjs.com/package/@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

| Tool | Auth | What it does |
|---|---|---|
| `hello_aigent_create_feed` | admin | Mint a feed + Ed25519 keypair + publisher token; returns the discovery file |
| `hello_aigent_list_feeds` | admin | List feeds you own |
| `hello_aigent_publish` | publish | Build + server-sign an update; delivered to subscribers |
| `hello_aigent_report_event` | publish | Report an action outcome (the "acted" analytics signal) |
| `hello_aigent_overview` | admin | KPI tiles, fetch sparkline, recent activity |
| `hello_aigent_funnel` | admin | subscribed → returned → acted funnel |
| `hello_aigent_event_log` | admin | Filterable, attributed audit log |
| `hello_aigent_subscribers` | admin | The owned-audience list (consent-aware) |
| `hello_aigent_discovery_file` | public | Generated `hello-aigent.json` to host at `/.well-known/` |

## Configure

Set in your MCP client config (env vars):

- `HELLOAIGENT_API` — API base (default `https://api.helloaigent.dev`)
- `HELLOAIGENT_ADMIN_TOKEN` — admin token; required for feed management + analytics
- `HELLOAIGENT_TOKEN` — publish token (a feed's publisher token, or the admin token); falls back to the admin token

Example (Claude Desktop / any MCP client):

```json
{
  "mcpServers": {
    "hello-aigent-publisher": {
      "command": "npx",
      "args": ["-y", "@helloaigent-dev/publisher"],
      "env": { "HELLOAIGENT_ADMIN_TOKEN": "admin_…" }
    }
  }
}
```

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?"*