Permite que um agente de IA gerencie feeds de publicadores, publique atualizações assinadas e acesse métricas de audiência.
Também conhecido como helloaigent-dev/helloaigent-publisher, @helloaigent-dev/publisher
- Stars
- 0
- Ferramentas
- 9
- Downloads, 30 dias
- 418
- Versão mais recente
- 0.1.1
- Último commit
- 22 de out. de 2026
- Licença
- MIT
O que é o MCP helloaigent-publisher?
Permite que um agente de IA gerencie feeds de publicadores, publique atualizações assinadas e acesse métricas de audiência. Ele expõe 9 ferramentas, como hello_aigent_create_feed, hello_aigent_list_feeds, hello_aigent_publish.
Resumo gerado a partir do README do projeto
Sobre o MCP server de helloaigent-publisher
Este servidor permite que profissionais de marketing gerenciem feeds de publicadores e métricas de audiência por meio de um agente de IA. Em vez de usar uma linha de comando ou um console de desenvolvedor, os usuários podem instruir um agente a lidar com todo o ciclo de vida de um feed, desde a criação inicial até a publicação de atualizações assinadas. Esta ferramenta atua como a contraparte do lado do produtor para o subscriber MCP, permitindo um ciclo completo de entrega de conteúdo e acompanhamento de desempenho.
Para usar este servidor, você deve configurar seu cliente MCP com uma API key de workspace que comece com hak_ ou um token de admin. O servidor utiliza essas credenciais para restringir todas as ações ao seu workspace específico, garantindo que você gerencie apenas os feeds e visualize as métricas que possui. Ele fornece ferramentas específicas como hello_aigent_create_feed para criar novos feeds com pares de chaves Ed25519 e hello_aigent_publish para entregar atualizações assinadas aos assinantes. Você também pode monitorar o desempenho por meio de ferramentas como hello_aigent_funnel e hello_aigent_overview para acompanhar as taxas de conversão de assinantes e atividades recentes.
O que você pode fazer com ele
- 1Criar e lançar novos feedsPeça ao seu agente para configurar um novo feed e gerar as chaves de segurança e os arquivos de descoberta necessários.
- 2Distribuir atualizações de conteúdo assinadasInstrua uma IA a construir e enviar uma atualização assinada para todos os assinantes atuais.
- 3Analisar métricas de conversão de audiênciaSolicite um relatório sobre quantos usuários passam de assinantes para usuários que realmente interagem com suas atualizações.
- 4Auditar engajamento de audiência e logsPeça ao seu agente para recuperar uma lista filtrada de eventos para ver como os usuários estão interagindo com seu feed.
Escrito a partir do README do projeto. Cada caso de uso é verificado com uma citação dele.
Como instalar o MCP helloaigent-publisher
Formatos verificados em 10 nov 2026Adicionar ao CursorAdicionar ao GooseInstalar o MCP helloaigent-publisher no Claude Code
$ claude mcp add --env 'HELLOAIGENT_ADMIN_TOKEN=<YOUR_HELLOAIGENT_ADMIN_TOKEN>' --env 'HELLOAIGENT_TOKEN=<YOUR_HELLOAIGENT_TOKEN>' helloaigent-publisher -- npx -y @helloaigent-dev/publisherInstalar o MCP helloaigent-publisher no Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"helloaigent-publisher": {
"command": "npx",
"args": [
"-y",
"@helloaigent-dev/publisher"
],
"env": {
"HELLOAIGENT_ADMIN_TOKEN": "<YOUR_HELLOAIGENT_ADMIN_TOKEN>",
"HELLOAIGENT_TOKEN": "<YOUR_HELLOAIGENT_TOKEN>"
}
}
}
}Instalar o MCP helloaigent-publisher no VS Code
.vscode/mcp.json
{
"servers": {
"helloaigent-publisher": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@helloaigent-dev/publisher"
],
"env": {
"HELLOAIGENT_ADMIN_TOKEN": "<YOUR_HELLOAIGENT_ADMIN_TOKEN>",
"HELLOAIGENT_TOKEN": "<YOUR_HELLOAIGENT_TOKEN>"
}
}
}
}Instalar o MCP helloaigent-publisher no VS Code CLI
$ code --add-mcp '{"name":"helloaigent-publisher","type":"stdio","command":"npx","args":["-y","@helloaigent-dev/publisher"],"env":{"HELLOAIGENT_ADMIN_TOKEN":"<YOUR_HELLOAIGENT_ADMIN_TOKEN>","HELLOAIGENT_TOKEN":"<YOUR_HELLOAIGENT_TOKEN>"}}'Instalar o MCP helloaigent-publisher no Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"helloaigent-publisher": {
"command": "npx",
"args": [
"-y",
"@helloaigent-dev/publisher"
],
"env": {
"HELLOAIGENT_ADMIN_TOKEN": "<YOUR_HELLOAIGENT_ADMIN_TOKEN>",
"HELLOAIGENT_TOKEN": "<YOUR_HELLOAIGENT_TOKEN>"
}
}
}
}Instalar o MCP helloaigent-publisher no Codex
$ codex mcp add helloaigent-publisher --env 'HELLOAIGENT_ADMIN_TOKEN=<YOUR_HELLOAIGENT_ADMIN_TOKEN>' --env 'HELLOAIGENT_TOKEN=<YOUR_HELLOAIGENT_TOKEN>' -- npx -y @helloaigent-dev/publisherInstalar o MCP helloaigent-publisher no Codex config.toml
~/.codex/config.toml
[mcp_servers.helloaigent-publisher] command = "npx" args = ["-y", "@helloaigent-dev/publisher"] [mcp_servers.helloaigent-publisher.env] HELLOAIGENT_ADMIN_TOKEN = "<YOUR_HELLOAIGENT_ADMIN_TOKEN>" HELLOAIGENT_TOKEN = "<YOUR_HELLOAIGENT_TOKEN>"
Instalar o MCP helloaigent-publisher no Gemini CLI
$ gemini mcp add -s user -e 'HELLOAIGENT_ADMIN_TOKEN=<YOUR_HELLOAIGENT_ADMIN_TOKEN>' -e 'HELLOAIGENT_TOKEN=<YOUR_HELLOAIGENT_TOKEN>' helloaigent-publisher npx -- -y @helloaigent-dev/publisherInstalar o MCP helloaigent-publisher no Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"helloaigent-publisher": {
"command": "npx",
"args": [
"-y",
"@helloaigent-dev/publisher"
],
"env": {
"HELLOAIGENT_ADMIN_TOKEN": "<YOUR_HELLOAIGENT_ADMIN_TOKEN>",
"HELLOAIGENT_TOKEN": "<YOUR_HELLOAIGENT_TOKEN>"
}
}
}
}Ferramentas do MCP helloaigent-publisher 9
Detectadas a partir do READMEhello_aigent_create_feedhello_aigent_list_feedshello_aigent_publishhello_aigent_report_eventhello_aigent_overviewhello_aigent_funnelhello_aigent_event_loghello_aigent_subscribershello_aigent_discovery_file
| hello_aigent_create_feed | — | |
| hello_aigent_list_feeds | — | |
| hello_aigent_publish | — | |
| hello_aigent_report_event | — | |
| hello_aigent_overview | — | |
| hello_aigent_funnel | — | |
| hello_aigent_event_log | — | |
| hello_aigent_subscribers | — | |
| hello_aigent_discovery_file | — |
Configuração
HELLOAIGENT_ADMIN_TOKENSecretoAdmin token — required for feed management and analytics tools
HELLOAIGENT_TOKENSecretoPublish token (a feed's publisher token); falls back to the admin token
HELLOAIGENT_APIAPI base URL (default https://api.helloaigent.dev)
HELLOAIGENT_API_KEY
| Nome | Descrição | Tipo |
|---|---|---|
| HELLOAIGENT_ADMIN_TOKEN | Admin token — required for feed management and analytics tools | Secreto |
| HELLOAIGENT_TOKEN | Publish token (a feed's publisher token); falls back to the admin token | Secreto |
| HELLOAIGENT_API | API base URL (default https://api.helloaigent.dev) | |
| HELLOAIGENT_API_KEY | — |
Verificações automatizadas
Executado em 13 de nov. de 2026Relatório completo →Passou em nossas verificações automatizadas. Isso não é uma auditoria de segurança: leia o código e dê ao servidor o acesso mais restrito de que ele precisa. Como as verificações funcionam
- Repositório de origem vinculado e acessívelPassou
- Licença de código aberto (OSI)Passou
- Commit ou release no último anoPassou
- Nome do pacote não é próximo a um pacote popularPassou
- O endpoint remoto usa HTTPSNão verificado
- Ferramentas destrutivas estão rotuladasPassou
- Sem instruções ocultas para o modeloPassou
- Nenhum aviso crítico no pacote ou em suas dependênciasPassou
README
Ver no 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
| Tool | Auth | What it does |
|---|---|---|
hello_aigent_create_feed |
workspace key or admin | Mint a feed + Ed25519 keypair + publisher token; returns the discovery file |
hello_aigent_list_feeds |
workspace key or admin | List feeds you own |
hello_aigent_publish |
publish token, workspace key, or admin | Build + server-sign an update; delivered to subscribers |
hello_aigent_report_event |
publish token, workspace key, or admin | Report an action outcome (the "acted" analytics signal) |
hello_aigent_overview |
workspace key or admin | KPI tiles, fetch sparkline, recent activity |
hello_aigent_funnel |
workspace key or admin | subscribed → returned → acted funnel |
hello_aigent_event_log |
workspace key or admin | Filterable, attributed audit log |
hello_aigent_subscribers |
workspace key or admin | The owned-audience list (consent-aware) |
hello_aigent_discovery_file |
public | Generated 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 (defaulthttps://api.helloaigent.dev)HELLOAIGENT_API_KEY— your workspace API key (hak_...); required for feed management + analytics unless using the admin token. Preferred overHELLOAIGENT_ADMIN_TOKENwhen both are set.HELLOAIGENT_ADMIN_TOKEN— admin token; alternative toHELLOAIGENT_API_KEY(ops/dogfood use only)HELLOAIGENT_TOKEN— publish token (a feed's own publisher token); falls back toHELLOAIGENT_API_KEY, thenHELLOAIGENT_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?"
Perguntas sobre o MCP helloaigent-publisher
Como adiciono o MCP helloaigent-publisher ao Claude Code?
Execute claude mcp add --env 'HELLOAIGENT_ADMIN_TOKEN=<YOUR_HELLOAIGENT_ADMIN_TOKEN>' --env 'HELLOAIGENT_TOKEN=<YOUR_HELLOAIGENT_TOKEN>' helloaigent-publisher -- npx -y @helloaigent-dev/publisher no seu terminal. Adicione --scope user para torná-lo disponível em todos os projetos.
Como adiciono o MCP helloaigent-publisher ao Cursor?
Abra ~/.cursor/mcp.json e adicione o servidor em mcpServers, usando a configuração do Cursor mostrada na seção de instalação acima.
Quais ferramentas o MCP helloaigent-publisher oferece?
Ele expõe 9 ferramentas, incluindo hello_aigent_create_feed, hello_aigent_list_feeds, hello_aigent_publish, hello_aigent_report_event, hello_aigent_overview.
Como eu crio um novo feed?
Você pode usar a ferramenta hello_aigent_create_feed, que requer uma workspace key ou um token de admin para criar um feed, um par de chaves Ed25519 e um publisher token.
O que é uma workspace key?
Uma workspace key é uma API key do tipo 'hak_...' gerada no console do Hello Aigent que limita o escopo das ferramentas ao seu workspace específico.
Uma workspace key pode ser usada para gerenciar feeds de outras pessoas?
Não, uma workspace key permite apenas visualizar e gerenciar os feeds que pertencem ao seu próprio workspace.