# LinkedIn MCP

> LinkedIn MCP Server connects your AI client directly to your professional network data. Use it to list all administered organizations, audit recent posts across profiles, retrieve detailed user info, or publish new content without ever touching the LinkedIn dashboard. It acts as a direct API bridge for managing your entire professional presence.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** professional-networking, content-publishing, profile-management, social-selling, lead-generation, business-identity

## Description

Yo, this server plugs your AI agent right into your whole professional network on LinkedIn. You don't have to touch a dashboard; you just tell your agent what you want done and it handles the dirty work. It acts like a direct API bridge for managing every piece of your online presence.

**Getting Your Profile Data Together**

When you need solid data, your AI client uses `get_me` to fetch detailed info about *your* authenticated user profile—that's name, job history, the whole shebang. It also pulls your primary verified email address using `get_email`, which keeps all your professional records consistent across every action.

**Managing Your Organizations**

The agent knows exactly what companies you run when it uses `list_organizations`. This tool spits out an array listing every single organizational page where your account has admin access. If you need deep context on just one of those places, the agent calls `get_organization`, which retrieves specific metadata and all the details for a single organization using its unique identifier. It’s how you audit everything you're connected to.

**Creating and Auditing Content**

Want to post somethin'? You tell your agent to use `create_post` to publish new text-based content—user-generated stuff, mind you—directly to either your personal profile or a specific company page. When it comes time to audit what's been posted, the agent runs `list_posts`. This queries and returns a list of recent posts by a specific author URN, letting you track exactly who said what and when. You can use this to check content performance or just keep tabs on your whole team’s posting rhythm.

**How It Works in Practice**

Your AI client doesn't know API calls; it knows natural language. When you ask, "List all the companies I manage," your agent translates that into a call using `list_organizations`. The server executes that tool and sends back structured data—the raw facts about every organization. You then tell the agent to write a new post, and it uses `create_post` with your text, handling the publication process entirely in the background. This setup lets you manage complex actions like checking credentials with `get_me` or pulling metadata for a specific company with `get_organization`, all without needing manual logins or dashboard clicks.

## Tools

### create_post
Publishes new text-based content (UGC) directly to your LinkedIn profile or a specified company page.

### get_email
Retrieves the primary verified email address associated with your authenticated LinkedIn account.

### get_me
Fetches detailed, current information about your own authenticated user profile on LinkedIn.

### get_organization
Retrieves specific metadata and details for a single LinkedIn organization using its unique identifier.

### list_organizations
Outputs an array listing every organizational page where your account holds administrative rights.

### list_posts
Queries and returns a list of recent posts made by a specific author URN, allowing for content auditing.

## Prompt Examples

**Prompt:** 
```
Get my LinkedIn profile and email.
```

**Response:** 
```
I've retrieved your profile. You are 'Marcus R.' and your primary email is 'marcus@vinkius.com'. Would you like to see your administered organizations?
```

**Prompt:** 
```
List all organizations I manage on LinkedIn.
```

**Response:** 
```
I've found 2 organizations where you are an administrator: 'Vinkius Labs' and 'Growth Tech'. Which one would you like the details for?
```

**Prompt:** 
```
Create a public post on my profile: 'Excited to launch our new MCP servers!'
```

**Response:** 
```
Post created successfully! Your update is now live on your profile with visibility set to PUBLIC. I've recorded the post URN for your audit.
```

## Capabilities

### Audit and List Admin Organizations
The agent can list every organization where your account has administrative access, retrieving metadata for each one.

### Create and Publish Posts
You instruct the agent to write and publish new user-generated content (UGC) directly to a specified profile or company page.

### Retrieve Core Profile Data
The system fetches your authenticated user details, including primary email and name, ensuring data consistency across all actions.

### Monitor Content Activity
You can query recent posts by a specific author URN to audit content performance or track who posted what.

### Get Specific Organization Details
The agent pulls comprehensive metadata for any single organization you specify, providing deep context on its profile.

## Use Cases

### Launching a New Product Initiative
A Marketing Manager needs to announce a product launch. Instead of copying and pasting the announcement into five different group pages, they ask their agent: 'Write an update about our new widget and publish it to all my managed groups.' The agent uses `list_organizations` first, then calls `create_post` for every single admin-controlled page, ensuring consistent messaging across the board.

### Rapid Recruitment Vetting
A Recruiter needs to check if a potential client company is still active. They prompt the agent: 'List all my managed organizations and get the details for 'Acme Corp'.' The agent uses `list_organizations` to confirm access, then calls `get_organization`, providing instant verification of the company's current status.

### Content Gap Analysis
A Content Strategist wants to know if their team has been posting enough. They ask: 'Show me all posts made by URN 123 in the last month.' The agent runs `list_posts`, providing a structured, sortable list that immediately highlights content gaps or over-saturation.

### Building an Outreach List
An SDR needs to update their CRM. They prompt: 'Get my profile details and primary email.' The agent uses `get_me` for general info and then calls `get_email`, giving the SDR two critical, verified data points ready for immediate use in a sales workflow.

## Benefits

- **Centralized Publishing:** Use `create_post` to write and publish content across all your managed organizational pages in one go. You don't have to log into each group individually; the agent handles the distribution, saving hours of manual dashboard work.
- **Full Profile Visibility:** The combined use of `get_me` and `get_email` instantly provides your AI client with verified personal data points. This means your agent can perform multi-step tasks that require both identity confirmation and contact details in a single workflow.
- **Instant Org Oversight:** Running `list_organizations` immediately shows you every group where you have admin rights. No more guesswork about which corporate pages need updating—the server gives you the complete list to audit against your content plan.
- **Content Performance Audits:** Instead of manually scrolling through posts, calling `list_posts` pulls a structured history of recent activity for any given author URN. This allows you to track engagement and identify gaps in your content strategy immediately.
- **Deep Organizational Context:** The `get_organization` tool goes beyond just knowing the name. It retrieves deep metadata about a specific corporate page, giving your agent enough context to write highly relevant posts or conduct accurate audits.

## How It Works

The bottom line is: you talk to your AI client like normal, and the server handles all the complex API calls in the background.

1. Subscribe to the server and provide your LinkedIn Access Token via the Vinkius platform.
2. Your AI client sends a request (e.g., 'Show me my email and all managed orgs') to the MCP Server.
3. The agent executes multiple tools (`get_email`, `list_organizations`) sequentially, returning structured data for your final review.

## Frequently Asked Questions

**How does the `create_post` tool work?**
The `create_post` tool publishes new content (UGC) directly. You must specify whether you are posting to your personal profile or an administered organization page, and provide the text for the post.

**What does `list_organizations` return?**
`list_organizations` returns a list of every unique ID and name for an organization where your account has admin status. This is critical for knowing which pages you can write to.

**Do I need to run `get_me` before using the other tools?**
While not strictly mandatory for all calls, running `get_me` first confirms your authenticated user context and ensures the agent has up-to-date information about your own profile details.

**Can I use `list_posts` to see posts from multiple people?**
No. The `list_posts` tool requires a specific author URN for each query. You must run the tool once per author you want to audit.

**What specific metadata do I get when using the `get_organization` tool?**
It returns deep details about a LinkedIn organization, including its industry, total employee count, and creation date. This lets you audit corporate profiles quickly without having to navigate the site.

**If my LinkedIn access token expires, how do I refresh credentials for `get_me`?**
The server requires manual re-authentication when your token expires. The agent will fail gracefully and prompt you to update the Access Token via the Vinkius dashboard.

**If I run `list_posts` or `create_post` too many times, how does the server handle rate limits?**
The server manages API rate limits using backoff logic. If a request hits LinkedIn's usage cap, it automatically waits and retries your command to prevent failure.

**Does `get_email` always pull my primary professional email address?**
Yes, the tool is designed to retrieve the authenticated user's primary registered email. This ensures you get the official email linked directly to your core LinkedIn account.

**How do I find my LinkedIn Access Token?**
Create a developer account at [**developer.linkedin.com**](https://developer.linkedin.com/), create an App, and perform the OAuth 2.0 flow to generate a token with the required permissions. Copy and paste it below.

**Can the agent post to my company page?**
Yes. Use the `create_post` tool providing the organization's URN as the author. Your agent will publish the content and confirm the status instantly.

**Is it possible to see my primary email via the agent?**
Yes. The `get_email` tool allows your agent to retrieve the primary email address associated with your LinkedIn account, ensuring your profile data is accurate.