# Linnia Docs

> Linnia is a LinkedIn API and MCP server for AI agents. It lets Claude, ChatGPT and other assistants (or your own code) research, connect, message and follow up on LinkedIn, while every action is paced inside working hours, kept within daily budgets and, in approve mode, approved by a person first.

- MCP server: https://mcp.linnia.ai/mcp (Streamable HTTP, OAuth 2.1 with dynamic client registration)
- REST API: https://api.linnia.ai (Authorization: Bearer lin_…)
- OpenAPI 3.1 spec: https://docs.linnia.ai/openapi.json
- API reference: https://docs.linnia.ai/api-reference/
- Dashboard: https://app.linnia.ai

## Getting started

- [Core concepts](https://docs.linnia.ai/getting-started/core-concepts/): Workspaces, seats, accounts, modes, jobs, approvals, budgets, working hours, warm-up and health.
- [Quickstart](https://docs.linnia.ai/getting-started/quickstart/): Accept your invite, connect LinkedIn and connect Claude, in about two minutes.
- [What is Linnia](https://docs.linnia.ai/getting-started/what-is-linnia/): Linnia connects your team's LinkedIn accounts to AI assistants and your own tools, and keeps every account inside safe limits.

## MCP server

- [Connect ChatGPT](https://docs.linnia.ai/mcp/chatgpt/): Add Linnia to ChatGPT as a connector in developer mode.
- [Connect Claude](https://docs.linnia.ai/mcp/claude/): Add Linnia to claude.ai and the Claude desktop app as a custom connector.
- [Connect Claude Code](https://docs.linnia.ai/mcp/claude-code/): Add Linnia to Claude Code with one command and authenticate with /mcp.
- [Connect Codex](https://docs.linnia.ai/mcp/codex/): Add Linnia to the OpenAI Codex CLI.
- [Connect Cursor](https://docs.linnia.ai/mcp/cursor/): Install Linnia in Cursor with one click or a few lines of JSON.
- [Example prompts](https://docs.linnia.ai/mcp/example-prompts/): Things to ask your assistant once Linnia is connected, from a morning check-in to a full outreach plan.
- [Other MCP clients](https://docs.linnia.ai/mcp/other-clients/): Connect any MCP client that supports Streamable HTTP and OAuth 2.1 with dynamic client registration.
- [MCP server](https://docs.linnia.ai/mcp/overview/): Use Linnia from Claude, ChatGPT, Cursor, VS Code, Codex or any MCP client with one remote server and OAuth sign-in.
- [Tools, prompts and resources](https://docs.linnia.ai/mcp/tools/): Every Linnia MCP tool, playbook prompt and resource, with what it does and what it needs.
- [MCP troubleshooting](https://docs.linnia.ai/mcp/troubleshooting/): Fix sign-in errors, 401s, missing accounts and permission errors, and revoke access.
- [Connect VS Code](https://docs.linnia.ai/mcp/vscode/): Use Linnia from GitHub Copilot agent mode in VS Code.

## User guides

- [Approvals](https://docs.linnia.ai/guides/approvals/): Review, edit, approve or reject what your assistant prepares before anything is sent on LinkedIn.
- [Automations](https://docs.linnia.ai/guides/automations/): Follow-up sequences that start when someone accepts or replies, and stop the moment they reply.
- [Connecting LinkedIn](https://docs.linnia.ai/guides/connecting-linkedin/): How to connect a rep's LinkedIn account, what to do when LinkedIn asks for a code or a check, and how to reconnect.
- [Safety and limits](https://docs.linnia.ai/guides/safety-and-limits/): Why Linnia uses working hours, budgets, warm-up, pacing and a health ladder, and how to tune them.
- [Seats and billing](https://docs.linnia.ai/guides/seats-and-billing/): How seats work in Linnia, how they're counted and how to get more.
- [Security](https://docs.linnia.ai/guides/security/): Passwords, two-factor authentication, recovery codes, sessions, API keys and how Linnia handles LinkedIn credentials.
- [Team and roles](https://docs.linnia.ai/guides/team-and-roles/): Invite teammates, choose between owner, admin and member, and disable access.

## API

- [Authentication](https://docs.linnia.ai/api/authentication/): Create an API key and send it as a bearer token.
- [Errors](https://docs.linnia.ai/api/errors/): The error envelope, every error type and the HTTP status it comes with.
- [Idempotency](https://docs.linnia.ai/api/idempotency/): How Linnia makes sure a retried request never sends the same LinkedIn action twice.
- [API introduction](https://docs.linnia.ai/api/introduction/): The Linnia REST API in five minutes. Base URL, authentication, jobs, errors and where to go next.
- [Jobs and polling](https://docs.linnia.ai/api/jobs/): The job lifecycle, long-polling with ?wait, results, and cancelling.
- [Rate limits](https://docs.linnia.ai/api/rate-limits/): Requests per minute per API key, the ratelimit headers, and how they differ from LinkedIn budgets.
- [Webhooks](https://docs.linnia.ai/api/webhooks/): Receive Linnia events (replies, accepted invitations, job results, account changes) on your own HTTPS endpoint, signed with HMAC-SHA256.

## Optional

- [Website](https://linnia.ai)
- [Website llms.txt](https://linnia.ai/llms.txt)