Reported issues for linkedctl

Pod holds 17 of 19 problems reported by people outside the maintainer team. Issues filed by the project's own owners, members and collaborators are excluded entirely — a maintainer's release checklist is not a warning to a prospective user.

Back to linkedctl.

Most discussed

Add Claude marketplace plugin and MCP skill documentation

What: Add Claude ecosystem integration files so LinkedCtl is discoverable and installable via Claude marketplaces (Smithery, Glama, MCP Registry) and includes a workflow skill for Claude Code users.

Changes made (committed on main, not yet pushed):

• .claude-plugin/plugin.json — plugin metadata for Claude marketplace listing
• .claude-plugin/marketplace.json — Smithery/Glama marketplace registration config
• .mcp.json — local MCP server config for Claude Desktop/Cursor
• `skills

Read the thread · 2026-03-10 · closed · 2 comments

(feat) HTTP client foundation

Description

LinkedIn API HTTP client with proper headers, error handling, and rate limiting.

Acceptance Criteria

• Sends correct headers: Authorization, Linkedin-Version, X-Restli-Protocol-Version, User-Agent
• On 429: exponential backoff retry (up to 3 retries)
• On 401: clear message directing user to re-authenticate
• On 5xx: clear server-side error message

Blocks: #2, #3, #4, #5, #6, #7, #8, #9

Read the thread · 2026-03-03 · closed · 1 comment

Split monolithic MCP server.ts into per-domain tool modules

Problem

packages/mcp/src/server.ts is 1,198 lines with all 22 tool registrations inline in a single createMcpServer() function. The post_create handler alone is 240 lines.

Solution

Split into domain modules following QontoCtl's pattern:

• tools/posts.ts — registerPostTools(server, getClient)
• tools/comments.ts — registerCommentTools(server, getClient)
• tools/reactions.ts — registerReactionTools(server, getClient)
• tools/orgs.ts — `registerOrgTools(server, getClien

Read the thread · 2026-03-10 · closed · 0 comments

Fix transitive CVEs via @modelcontextprotocol/sdk

Problem

5 known CVEs in transitive dependencies via @modelcontextprotocol/sdk@1.27.1:

Read the thread · 2026-03-10 · closed · 0 comments

Update README to reflect v0.5.0 capabilities

Problem

README documents only v0.1.0 capabilities:

• MCP tools section lists 3 tools (post_create, auth_status, auth_revoke) — actual: 22 tools
• CLI Reference section covers only auth, text post, profile, whoami — missing: media upload, comments, reactions, orgs, analytics, polls, drafts

Scope

Update README to cover:

• All 22 MCP tools in the Available Tools table
• Full CLI command tree (media, comment, reaction, org, stats)
• Rich post types (image, video, document,

Read the thread · 2026-03-10 · closed · 0 comments

MCP: add unified error handling to all 22 tools

Problem

14 of 22 MCP tools have no LinkedInAuthError handling. When auth expires, these tools throw unhandled exceptions instead of returning actionable guidance.

Tools with handling (6): whoami, reaction_create, reaction_list, reaction_delete, auth_status, auth_revoke

Tools WITHOUT handling (14): post_create, post_get, post_list, post_update, post_delete, comment_create, comment_list, comment_get, comment_delete, document_upload, org_list, `org_

Read the thread · 2026-03-10 · closed · 0 comments

Org stats MCP tools

org-stats-mcp

Type: story Component: Stats MCP Tools (org) Priority: Should Scope: member-post-analytics (HQ-scoped)

MCP tool stats_org for organization share statistics. Includes per-tool profile parameter.

Acceptance Criteria

• Given an MCP client calling stats_org with an org ID, Then JSON org stats are returned
• Given stats_org with date range and granularity, Then

Read the thread · 2026-03-09 · closed · 0 comments

Member stats MCP tools

member-stats-mcp

Type: story Component: Stats MCP Tools (member) Priority: Must Scope: member-post-analytics (HQ-scoped)

MCP tool definitions stats_post and stats_me for member post analytics. Includes per-tool profile parameter for multi-app auth (ADR-001).

Acceptance Criteria

• Given an MCP client calling stats_post with a post URN, Then JSON stats are returned with al

Read the thread · 2026-03-09 · closed · 0 comments

Most recent

Org stats API client

org-stats-api

Type: story Component: Org Stats API Client Priority: Should Scope: member-post-analytics (HQ-scoped)

API integration for LinkedIn organizationalEntityShareStatistics endpoint. Single-call endpoint with time-bound filtering (DAY/MONTH granularity) and per-post filtering.

Acceptance Criteria

• Given an org ID and rw_organization_admin scope, When fetching lifeti

Read the thread · 2026-03-09 · closed · 0 comments

(docs) add claude mcp add installation instructions

Context

The MCP README documents Claude Desktop configuration but not the claude mcp add CLI command for Claude Code users.

Requirements

Add installation instructions for Claude Code:

claude mcp add linkedctl -- npx linkedctl mcp

Also document Cursor and Windsurf configuration where applicable.

References

• QontoCtl MCP README covers all four clients (Claude Desktop, Claude Code, Cursor, Windsurf)

Read the thread · 2026-03-06 · closed · 0 comments

(feat) add glama.json for Glama AI marketplace listing

Context

QontoCtl is listed on the Glama AI marketplace via a glama.json file. LinkedCtl's MCP server is not discoverable there.

Requirements

Add glama.json following the Glama schema (https://glama.ai/mcp/schemas/server.json):

• Register maintainer(s)
• Include server metadata

References

• QontoCtl's glama.json as reference implementation
• Glama MCP servers directory

Read the thread · 2026-03-06 · closed · 0 comments

(feat) add server.json for MCP Registry listing

Context

QontoCtl is registered in the MCP Registry via a server.json file at the repo root. LinkedCtl's MCP server exists but is not discoverable through the registry.

Requirements

Add server.json following the MCP Registry schema (https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json):

• Name: io.github.alexey-pelykh/linkedctl
• Transport: stdio
• Registry type: npm
• Package ID: `linkedc

Read the thread · 2026-03-06 · closed · 0 comments

(ux) MCP error messages should not reference CLI commands

Problem

MCP tool error messages reference CLI commands (e.g., 'Run "linkedctl profile create"'), but MCP users may not have CLI access or know CLI commands.

Expected Behavior

Error messages should be channel-appropriate:

• CLI errors → suggest CLI commands
• MCP errors → suggest config file actions or MCP tools

Acceptance Criteria

• Given an MCP tool error, When the error message is shown, Then it does not reference linkedctl CLI commands
• Given an auth error in MCP, When shown,

Read the thread · 2026-03-05 · closed · 0 comments

(ux) add whoami MCP tool

Problem

The MCP server has no whoami equivalent. MCP clients (Claude, Cursor) cannot verify which LinkedIn user they're acting as before creating posts.

Expected Behavior

A whoami MCP tool that returns the current user's name, email, and profile picture URL.

Acceptance Criteria

• Given a valid access token, When the whoami tool is called, Then the user's name, email, and picture are returned
• Given an expired token, When the tool is called, Then a clear error with re-authent

Read the thread · 2026-03-05 · closed · 0 comments

(docs) add per-package READMEs for core, cli, mcp

Context

Documentation audit findings DOCS-004, DOCS-005 (🟡 Medium).

@linkedctl/core, @linkedctl/cli, and @linkedctl/mcp are published to npm with "access": "public" but have no README. npm shows blank package pages.

For @linkedctl/core, the root README acknowledges library usage ("Your combined work must be licensed under AGPL-3.0"), but there is no API surface documentation.

Acceptance Criteria

• packages/core/README.md exists with purpose, installation, API surface s

Read the thread · 2026-03-04 · closed · 0 comments

(docs) document MCP tools in README

Context

Documentation audit finding DOCS-006 (🟡 Medium).

The MCP server registers 3 tools (post_create, auth_status, auth_revoke) but none are documented. Users integrating with Claude or other MCP clients have no tool reference.

Acceptance Criteria

• README MCP Integration section lists available tools
• Each tool has parameters and description matching packages/mcp/src/server.ts
• Tool names, input schemas, and descriptions are accurate

Scope Document

`docs/s

Read the thread · 2026-03-04 · closed · 0 comments

(docs) fix CLAUDE.md package exports description

Context

Documentation audit finding DOCS-010 (🔴 Critical).

CLAUDE.md Package Exports section (lines 101-112) states all packages use:

"exports": { ".": { "types": "./dist/index.d.ts", "import": "./dist/index.js" } }

This is inaccurate for two packages:

• packages/linkedctl exports ./dist/cli.d.ts + ./dist/cli.js
• packages/mcp has 3 export entries (., ./server, ./stdio) using server.d.ts/server.js

Acceptance Criteria

• CLAUDE.md Package Exports sectio

Read the thread · 2026-03-04 · closed · 0 comments

The remaining reports are on the project's issue tracker.