linkedin

LinkedIn

Skill for publishing to LinkedIn through the LinkedIn integration exposed by the Hyper MCP.

Out of scope — defer to other skills

Requirements

• Hyper MCP installed and connected. https://app.hyperfx.ai/mcp
• LinkedIn integration connected at https://app.hyperfx.ai/apps.
• For company-page posts, the connected member account must have permission to post for that organization.

If linkedin_create_text_post is not in the tool list, stop and tell the user to enable Hyper MCP and connect LinkedIn.

Tool surface

Posting Rules

1. Use linkedin_create_text_post for standard member or organization posts.
2. Use linkedin_create_organization_post when the user explicitly wants to post as a company page and you already know the organization_id.
3. Use linkedin_create_document_post for PDF / document uploads. LinkedIn renders PDF pages as a swipeable document post.
4. Use linkedin_create_carousel_from_text when the user wants a text-to-carousel workflow driven by AI-generated slides.

Article / Link Posts

Do not rely on LinkedIn to scrape Open Graph metadata for API-created posts.

For reliable article posts:

• Provide article_url.
• Prefer explicit article_title, article_description, and thumbnail_url.
• If those fields are omitted, the backend may derive them from the shared page metadata, but explicit values are still more reliable.

Use this shape when editing or preparing a LinkedIn article post:

linkedin_create_text_post(
    text="Caption text",
    article_url="https://example.com/article",
    article_title="Explicit preview title",
    article_description="Explicit preview description",
    thumbnail_url="https://example.com/thumbnail.jpg",
    organization_id="123456789",  # optional
)

Document and Carousel Posts

LinkedIn carousels are implemented as document posts backed by a PDF.

Native PDF flow

Use linkedin_create_document_post when you already have a PDF URL or stored file ID:

linkedin_create_document_post(
    text="Caption text",
    title="Deck title",
    document_url="https://example.com/deck.pdf",
    organization_id="123456789",  # optional
)

Text-to-carousel flow

Use linkedin_create_carousel_from_text when the user wants the system to build the carousel from a block of source text:

linkedin_create_carousel_from_text(
    text_content="Source content for the slides",
    title="Carousel title",
    caption="LinkedIn caption",
    num_slides=4,
    style="professional",
    color_scheme="blue",
    organization_id="123456789",  # optional
)

The current implementation:

• Parses the source text into slide content.
• Generates a single grid image with an image model.
• Splits the grid into individual slide images.
• Assembles a PDF.
• Publishes the PDF as a LinkedIn document post.
• Returns the live post URL — present this to the user to confirm the carousel is live.

Supported slide counts are 4, 6, and 9.

Manual Slide Editing

The current LinkedIn carousel pipeline is PDF-based. It does not provide a first-class live canvas editing loop before publish.

If a user wants manual refinement:

1. Generate the carousel assets first.
2. Review or edit the generated slide images / PDF externally.
3. Post the final PDF with linkedin_create_document_post.

Do not promise an in-product editable canvas workflow unless the tool is actually available in the current environment.

Organization Posting

When posting to a company page:

• If you don't know the organization_id, call linkedin_get_my_managed_pages() first — it returns all company pages the connected account can post to, with their IDs.
• Use linkedin_get_organization_posts_detailed(organization_id=...) to preview recent posts before publishing — avoids accidental duplicates.
• Pass organization_id to whichever posting tool you're using.
• Expect LinkedIn org posting permissions to matter.
• If a post fails with a permissions error, verify that the authenticated account can post to that organization.

Failure Modes & Recovery

• Article preview is empty / wrong. LinkedIn ignored the scraped metadata. Re-call linkedin_create_text_post with explicit article_title, article_description, and thumbnail_url.
• Permission error on organization post. Confirm with the user that their LinkedIn account has page-posting permission for the target organization_id.
• `linkedin_create_carousel_from_text` returned an unexpected slide count. Only num_slides of 4, 6, or 9 are supported.
• Document post fails with an invalid URL. The document_url must be a directly-fetchable PDF (no auth, no HTML redirect page).