Get the current Engain user and the list of projects (campaigns) they can access. Use this first to discover projectId values for other tools.

Get remaining credits and free comments for the authenticated Engain workspace.

List credit transaction history for a project (newest first), paginated via cursor.

List a project's tasks (comments/posts/replies), newest first, paginated via cursor.

Get a single task by ID. Set refreshMetrics to pull live upvote/reply counts.

Fetch up to 100 tasks by ID in one call.

Get recommended upvote metrics for a Reddit post or comment URL. Rate-limited to 5 requests/minute. Does not spend credits.

Create a Reddit comment task on a thread URL. SPENDS CREDITS (typically 5).

Create a Reddit post task in a subreddit. SPENDS CREDITS (typically 10).

Create a Reddit reply task to a specific comment URL. SPENDS CREDITS (typically 5).

Create a threaded group of tasks (a parent task plus child replies). SPENDS CREDITS per task in the group.

List a project's upvote/downvote orders, paginated. Filter by status OR campaignId (not both).

Get a single order by ID.

Fetch up to 100 orders by ID in one call.

Create an upvote order on a Reddit post or comment. SPENDS CREDITS (~0.1 per vote).

Create a downvote order on a Reddit post or comment. SPENDS CREDITS.

List discovered opportunities for a project. type selects new Reddit opportunities or SEO opportunities.

Get a single opportunity by ID.

List brand mentions discovered for a project, filterable by brand and sentiment.

Get a single mention by ID.

Get aggregated sentiment counts for a project's mentions, optionally for one brand.

Get per-brand mention counts for a project.

List all labels defined in a project.

Create a new label in a project.

Delete a label from a project by name.

Add one or more labels to a task.

Remove one or more labels from a task.

Add one or more labels to an order.

Remove one or more labels from an order.