> ## Documentation Index
> Fetch the complete documentation index at: https://www.outx.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Server, Connect AI Agents to OutX

> Use the OutX MCP server to connect Claude, Cursor, Claude Code, and other AI agents to LinkedIn social listening and data via natural language.

The OutX MCP server lets AI agents interact with the full OutX API through the [Model Context Protocol](https://modelcontextprotocol.io). Create watchlists, search posts, fetch profiles, and engage on LinkedIn, all via natural language prompts.

## Install

```bash theme={null}
npx outx-mcp-server
```

Requires Node.js 18+ and an OutX API key. [Get your key](https://mentions.outx.ai/api-doc).

The server runs locally, launched by your MCP client over stdio through `npx`. There is no hosted or remote endpoint for the OutX API, so there is no URL to point a client at.

If your client offers to connect an **OutX AI Docs MCP** advertised from this site's `/.well-known`, that is a different thing: Mintlify publishes it automatically and it only searches these documentation pages. It cannot create watchlists, read posts, or take any action on your account. For that, use `outx-mcp-server` locally as shown above.

## Setup

### Claude Desktop

Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:

```json theme={null}
{
  "mcpServers": {
    "outx": {
      "command": "npx",
      "args": ["-y", "outx-mcp-server"],
      "env": {
        "OUTX_API_KEY": "your-api-key"
      }
    }
  }
}
```

### Cursor

Add to `.cursor/mcp.json` in your project:

```json theme={null}
{
  "mcpServers": {
    "outx": {
      "command": "npx",
      "args": ["-y", "outx-mcp-server"],
      "env": {
        "OUTX_API_KEY": "your-api-key"
      }
    }
  }
}
```

### Claude Code

Add to `.mcp.json` in your project:

```json theme={null}
{
  "mcpServers": {
    "outx": {
      "command": "npx",
      "args": ["-y", "outx-mcp-server"],
      "env": {
        "OUTX_API_KEY": "your-api-key"
      }
    }
  }
}
```

## Available Tools

### Watchlist Management

33 tools covering the full OutX API. Both create modes live on one tool: pass `prompt` for AI mode or `keywords` for direct mode.

| Tool | Description |
| - | - |
| `create_keyword_watchlist` | Monitor LinkedIn posts, from a `prompt` or from `keywords` |
| `list_keyword_watchlists` | List all keyword watchlists |
| `update_keyword_watchlist` | Update name, keywords, labels, frequency, or status, or regenerate from a new prompt |
| `delete_keyword_watchlist` | Delete a keyword watchlist |
| `create_reddit_watchlist` | Monitor Reddit posts and comments, from a `prompt` or from `keywords` |
| `list_reddit_watchlists` | List all Reddit watchlists |
| `update_reddit_watchlist` | Update name, keywords, labels, frequency, or status, or regenerate from a new prompt |
| `delete_reddit_watchlist` | Delete a Reddit watchlist |
| `create_people_watchlist` | Track posts from specific LinkedIn profiles |
| `list_people_watchlists` | List all people watchlists |
| `update_people_watchlist` | Update name or status |
| `delete_people_watchlist` | Delete a people watchlist |
| `create_company_watchlist` | Monitor posts from LinkedIn company pages |
| `list_company_watchlists` | List all company watchlists |
| `update_company_watchlist` | Update name or status |
| `delete_company_watchlist` | Delete a company watchlist |

### Posts, Engagement & Account

| Tool | Description |
| - | - |
| `get_posts` | Search and filter posts with 15+ parameters |
| `get_interactions` | Retrieve likes and comments for posts in a watchlist with filtering, pagination, and daily graph data |
| `like_watchlist_post` | Like a watchlist post |
| `comment_on_watchlist_post` | Comment on a watchlist post |
| `list_watchlists` | Every watchlist of the team across all four types (id, type, name, slug, disabled, default labels); call it before creating anything |
| `get_team` | Read your plan, limits, and current usage |

### LinkedIn Data API

These tools wrap the async LinkedIn Data API. The MCP server handles polling automatically -- you get the result directly.

| Tool | Description |
| - | - |
| `fetch_linkedin_profile` | Fetch a profile by slug (name, headline, experience, education, skills) |
| `fetch_linkedin_profile_posts` | Fetch posts from profiles by URN |
| `fetch_linkedin_company` | Fetch company page data by slug (industry, employee count, description) |
| `fetch_linkedin_company_posts` | Fetch recent posts from a company page |
| `search_linkedin_profiles` | Search LinkedIn profiles by title, company, location, and more |
| `fetch_linkedin_connections` | Fetch your 1st-degree connections with keyword search and pagination |
| `send_linkedin_message` | Send a direct message to a 1st-degree connection |
| `send_linkedin_connection_request` | Send a connection request, with an optional note |
| `like_linkedin_post` | Like a post by activity URN |
| `comment_on_linkedin_post` | Comment on a post by activity URN |
| `get_task_status` | Check status of an async task manually |

> [!WARNING]
>
> LinkedIn Data tools require the [OutX Chrome extension](https://www.outx.ai/docs/resources/chrome-extension.md) to be active within the last 48 hours.

## Example Prompts

Once connected, try these with your AI agent:

**Social listening:**

* "Create a watchlist to monitor LinkedIn posts about AI startups raising Series A"
* "Show me trending posts from my watchlists this week"
* "What are VPs posting about machine learning?"

**Profile & company research:**

* "Fetch the LinkedIn profile for williamhgates"
* "Get recent posts from this prospect's profile"
* "Get company info and recent posts for OpenAI"
* "Search for VPs of Engineering at Google in the US"
* "Show me my most recently added connections"

**Engagement & messaging:**

* "Like the most engaging post about product management"
* "Comment 'Great insights!' on this post"
* "Send a message to this connection thanking them for connecting"

## How It Works

The MCP server connects to the OutX API using your API key. When an AI agent calls a tool:

1. The server translates the tool call into an OutX API request
2. For LinkedIn Data tools, it automatically submits the async task and polls until complete
3. Results are returned as structured JSON the agent can reason about

```
AI Agent ←→ MCP Protocol ←→ OutX MCP Server ←→ OutX API ←→ LinkedIn
```

## Source Code

The MCP server is published on npm as [outx-mcp-server](https://www.npmjs.com/package/outx-mcp-server). Version 1.8.0 (2026-08-28) adds `list_watchlists`, member editing on people and company watchlists, `labels=default` on `get_posts`, and failure reasons on task status.

***

## Partnerships

Interested in a collaboration or affiliate partnership? Reach out at [support@outx.ai](mailto:support@outx.ai).

## Learn More

* [How to Connect AI Agents to LinkedIn](https://www.outx.ai/blog/linkedin-api-for-ai-agents)
* [LinkedIn API Guide](https://www.outx.ai/blog/linkedin-api-guide)
* [LangChain Integration](https://www.outx.ai/docs/integrations/langchain.md)
* [Python SDK](https://www.outx.ai/docs/integrations/python-sdk.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.