English Français العربية

io.github.pooriaarab/agentic-engage

Official registry AI and agents

Plan and send approved engagement on social platforms.

Source code Documentation

What can you do with io.github.pooriaarab/agentic-engage?

  • Drafts: Generate fixed template text with an AI-assistance disclosure.
  • Review: Approve or deny actions; execution requires approved status.
  • Queue: Deduplicate target IDs and keep an in-memory audit log.
  • HTTP adapter: POST target and text to an endpoint you supply.
  • Guards: Optional dispatch caps, UTC quiet hours, and text blocklists.

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package agentic-engage
Claude Code 
claude mcp add agentic-engage -- npx -y agentic-engage@0.1.0 mcp
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "agentic-engage": {
            "command": "npx",
            "args": [
                "-y",
                "agentic-engage@0.1.0",
                "mcp"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. agentic-engage
  2. Install
  3. Preview your first action
  4. Features and coverage
  5. Runtime surfaces
  6. Limits and status
  7. Links and license

agentic-engage

agentic-engage is an open-source engagement queue for Node.js developers and agents, with approval steps, local receipts, and a generic HTTP adapter.

Install

npm install agentic-engage

Requires Node.js 18 or later. Includes TypeScript declarations and two runtime dependencies.

Preview your first action

Save this as preview.mjs, then run node preview.mjs. No credentials are needed.

import {
  createEngagementQueue, planEngagement, approveEngagement,
  executeEngagement, getCostReport,
} from "agentic-engage";

const queue = createEngagementQueue();
const [draft] = planEngagement(
  [{ id: "post-1", platform: "webhook", context: "your launch" }],
  "Helpful brand", queue,
);
approveEngagement(draft.id, queue);
const preview = await executeEngagement(draft.id, { queue });
console.log(preview.dryRun, preview.action.status); // true approved
console.log(getCostReport()); // entries: [], dispatches: 0, units: 0

Success prints true approved and zero dispatch costs. Preview makes no delivery request.

Features and coverage

  • Drafts: Generate fixed template text with an AI-assistance disclosure.
  • Review: Approve or deny actions; execution requires approved status.
  • Queue: Deduplicate target IDs and keep an in-memory audit log.
  • HTTP adapter: POST target and text to an endpoint you supply.
  • Guards: Optional dispatch caps, UTC quiet hours, and text blocklists.
Target labelNative integration status
Redditscaffold; generic HTTP or local receipt only
X (Twitter)scaffold; generic HTTP or local receipt only
LinkedInscaffold; generic HTTP or local receipt only
YouTubescaffold; generic HTTP or local receipt only
Blueskyscaffold; generic HTTP or local receipt only
WebhookGeneric HTTP adapter implemented; endpoint supplied by caller

Six target labels share two engagement adapter classes. No native social API is credential-verified. Use new HttpEngagementAdapter("webhook", { endpoint }) in the library's adapters map. Your endpoint handles authentication and platform delivery. No vendor environment variables or .env loader exist.

Runtime surfaces

CLI commands: plan, queue, approve, deny, send, costs, and mcp; also --help and --version. Run npx agentic-engage mcp or npx --package agentic-engage agentic-engage-mcp for Model Context Protocol (MCP). Tools: plan_engagement, get_engagement_queue, approve_engagement, deny_engagement, execute_engagement, and get_cost_report. Worker source exposes GET /health, POST /summarize, and POST /plan; you deploy it yourself.

Limits and status

Queues and costs reset when the process exits. Separate CLI invocations do not share actions. CLI and MCP live execution use local receipts; they cannot configure HTTP adapters. Library execution also defaults to local receipts without an adapter, even with live: true. A sent status therefore does not prove social publication. HTTP receipts use locally generated IDs. HTTP requests default to a 10-second timeout with no retries. Costs count characters, not currency. Drafts use fixed text templates; no language model generates them. Account ownership is not verified. Version 0.1.0 has an API that may change. No managed social delivery service is included.

Package and releases · MIT license

Frequently asked questions

What is io.github.pooriaarab/agentic-engage?

Plan and send approved engagement on social platforms.

How do I install io.github.pooriaarab/agentic-engage?

It runs on your machine. In Claude Code: claude mcp add agentic-engage -- npx -y agentic-engage@0.1.0 mcp. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.pooriaarab/agentic-engage need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.pooriaarab/agentic-engage open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.pooriaarab/agentic-engage?

It is published by pooriaarab. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.