Agent Quickstart

LinkedMash is a saved posts API and MCP server for LinkedIn: it gives an AI agent tools to search a user's saved LinkedIn posts and to create, schedule, publish, and analyze LinkedIn content. Connect over MCP (recommended) or REST; setup takes about two minutes.

Point your agent at Linkedmash with a single API token. Connect over MCP for a ready-made tool set, or call the REST API at https://api.linkedmash.com/v1 directly. Both paths use the same token and the same account.

Connect in four steps

Get an API token

Generate a token in your Linkedmash account. The agent sends it on every request as Authorization: Bearer <token>. Treat it like a password — never commit it or share it.

Get your API token →

Connect the agent

Pick how the agent talks to Linkedmash. MCP is recommended — your agent gets typed tools with no HTTP plumbing.

Option A — MCP (recommended)

Follow Connect Your Agent for copy-paste config for Claude Desktop, Claude Code, Cursor, VS Code, and more — the agent gets all 22 tools automatically. The hosted server is https://mcp.linkedmash.com/api/mcp with your API token in the URL.

Option B — REST

Call https://api.linkedmash.com/v1 directly with a bearer token. Use this when your agent already speaks HTTP or MCP isn't available.

›Authorization: Bearer YOUR_API_TOKEN

Know the capabilities

Saved posts work on any plan. Free accounts get a 20-result sample per request and 100 API/MCP calls per UTC day; a paid plan unlocks the full library, paging, filters, and higher limits. Content Studio, Scheduling, and Analytics require a paid Premium or Lifetime plan.

Saved posts

List, search, fetch, count, and label a user's saved LinkedIn posts. Available on every plan; free accounts are sampled (20 results per request) and have a daily call limit.

Content Studio (paid)

Create, read, update, and delete post drafts, and upload media to attach.

Scheduling (paid)

Schedule drafts to the next open slot or a set time, manage the queue, and edit the recurring schedule.

Analytics (paid)

Read aggregate account metrics and per-post performance over a date range.

Install the skill and try it

Install the Linkedmash skill in your agent — npx skills add linkedmash/agent-skills (Claude Code, Cursor, …) — so it knows the tools and workflows, then run an example.

First request

List the most recent saved posts for the authenticated user:

cURL

curl -X GET "https://api.linkedmash.com/v1/bookmarks?limit=5" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Over MCP, the same call is just the list_bookmarks tool — no URL or headers to assemble:

MCP

https://mcp.linkedmash.com/api/mcp?token=YOUR_API_TOKEN

Heads up: Content Studio, Scheduling, and Analytics tools and endpoints require an active paid Premium or Lifetime plan. Saved-post tools work on any plan, with a 20-result sample and 100 API/MCP calls per UTC day on free accounts.

Getting Started

Connect Your Agent