---
title: "Run Company Commenting Pipeline"
method: POST
path: "/mcp/tools/run_company_commenting_pipeline"
tags: ["mcp"]
---

# Run Company Commenting Pipeline

`POST /mcp/tools/run_company_commenting_pipeline`

## Request

- Base URL: `https://api.iridiumhqmcp.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.iridiumhqmcp.com/mcp/tools/run_company_commenting_pipeline`
- Auth: HTTP bearer

Generate LinkedIn comment drafts on recent posts by people who work at specific companies.

USE THIS when the user names one or more companies:
  "comment on posts from people at Stripe"
  "I want to be visible to Anthropic and OpenAI engineers"
  "engage with anything Ramp employees posted this week"

DO NOT USE for topic- or keyword-based commenting ("find me AI posts to comment on",
"comment on posts about RAG"). Use run_commenting_pipeline instead, which searches the
whole of LinkedIn by the user's saved comment_topics.

How it differs: this tool searches by AUTHOR COMPANY and recency only, with no keyword
filter, because ANDing a keyword against a single employer usually returns nothing.
Topical relevance is then judged by the model over whatever those employees actually
posted. As a result it may legitimately return zero drafts if nobody at those companies
posted anything worth engaging with; that is a valid outcome, not an error, and you
should say so plainly rather than retrying.

Takes up to 5 companies per call. Companies with no matching LinkedIn page come back in
unresolved_companies, so tell the user which ones failed.

After calling this tool, ALWAYS display every draft to the user in full:

  **Post by [author_name] ([company]):**
  [post_text, the complete text, never truncated]

  **Drafted comment:**
  [comment_text, displayed in full]

Do NOT call approve_comment_draft or schedule anything unless the user explicitly asks.

Args:
    companies: Company names, e.g. ["Stripe", "Ramp"]. Max 5.
    n: How many drafts to generate (default 3, capped by the user's remaining daily cap).
    date_posted: "past_24h" | "past_week" | "past_month". Default "past_week".

## Request body

- CompanyCommentRequest
  - `companies` string[], required
  - `n` integer
  - `date_posted` string

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/iridiumhqmcp/apis/iridium-linkedin-for-ai-agents.md) · [All operations](https://skmtc.dev/iridiumhqmcp/apis/iridium-linkedin-for-ai-agents/llms.txt) · [OpenAPI document](https://skmtc.dev/iridiumhqmcp/apis/iridium-linkedin-for-ai-agents/revisions/b9f5e020543c?raw)