engain-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| ENGAIN_API_KEY | Yes | Your Engain API key (eng_…). Sent as the X-API-Key header. | |
| ENGAIN_BASE_URL | No | API host. Point at a non-prod deployment for testing. | https://api.engain.io |
| ENGAIN_PROJECT_ID | No | Default project ID for project-scoped tools when one isn't passed. | |
| ENGAIN_MCP_READONLY | No | When truthy (1/true/yes), all credit-spending tools are hidden. | false |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| engain_get_meA | Get the current Engain user and the list of projects (campaigns) they can access. Use this first to discover projectId values for other tools. |
| engain_get_balanceA | Get remaining credits and free comments for the authenticated Engain workspace. |
| engain_list_credit_transactionsA | List credit transaction history for a project (newest first), paginated via cursor. |
| engain_list_tasksA | List a project's tasks (comments/posts/replies), newest first, paginated via cursor. |
| engain_get_taskA | Get a single task by ID. Set refreshMetrics to pull live upvote/reply counts. |
| engain_get_tasks_bulkA | Fetch up to 100 tasks by ID in one call. |
| engain_get_rank_metricsA | Get recommended upvote metrics for a Reddit post or comment URL. Rate-limited to 5 requests/minute. Does not spend credits. |
| engain_create_comment_taskC | Create a Reddit comment task on a thread URL. SPENDS CREDITS (typically 5). |
| engain_create_post_taskC | Create a Reddit post task in a subreddit. SPENDS CREDITS (typically 10). |
| engain_create_reply_taskB | Create a Reddit reply task to a specific comment URL. SPENDS CREDITS (typically 5). |
| engain_create_thread_task_groupA | Create a threaded group of tasks (a parent task plus child replies). SPENDS CREDITS per task in the group. |
| engain_list_ordersA | List a project's upvote/downvote orders, paginated. Filter by status OR campaignId (not both). |
| engain_get_orderC | Get a single order by ID. |
| engain_get_orders_bulkB | Fetch up to 100 orders by ID in one call. |
| engain_create_upvote_orderB | Create an upvote order on a Reddit post or comment. SPENDS CREDITS (~0.1 per vote). |
| engain_create_downvote_orderB | Create a downvote order on a Reddit post or comment. SPENDS CREDITS. |
| engain_list_opportunitiesB | List discovered opportunities for a project. type selects new Reddit opportunities or SEO opportunities. |
| engain_get_opportunityC | Get a single opportunity by ID. |
| engain_list_mentionsC | List brand mentions discovered for a project, filterable by brand and sentiment. |
| engain_get_mentionC | Get a single mention by ID. |
| engain_get_mention_statsA | Get aggregated sentiment counts for a project's mentions, optionally for one brand. |
| engain_get_mention_brandsB | Get per-brand mention counts for a project. |
| engain_list_labelsB | List all labels defined in a project. |
| engain_create_labelC | Create a new label in a project. |
| engain_delete_labelB | Delete a label from a project by name. |
| engain_add_task_labelsC | Add one or more labels to a task. |
| engain_remove_task_labelsC | Remove one or more labels from a task. |
| engain_add_order_labelsB | Add one or more labels to an order. |
| engain_remove_order_labelsC | Remove one or more labels from an order. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 29 tools
Every tool targets a specific action on a distinct resource (labels, tasks, orders, mentions, opportunities, credits). Even bulk versions are clearly separated from single-item tools. No overlapping purposes.
All tools follow a uniform 'engain_verb_noun' pattern in snake_case, with verbs like add, create, delete, get, list, remove. No mixing of styles or naming conventions.
29 tools is on the higher side but well-justified by the breadth of the domain (labels, tasks, orders, mentions, opportunities, credits). The tools are grouped by resource, making the set manageable.
The set covers creation and retrieval for most resources but lacks update and delete for tasks and orders. Labels are fully covered. Gaps exist for modifying or removing core entities.