About curviate
curviate is a hosted MCP server for agents that perform LinkedIn work through a Curviate workspace and connected account. It provides search, messaging, posts, and connection requests through one remote URL, with OAuth or API-key authentication.
Key features
- 01Search LinkedIn
- 02Manage messaging and draft replies
- 03Create and review posts
- 04Request connections
- 05Enable Sales Navigator and Recruiter tools per workspace
Use cases
- 01Find prospects matching role, industry, and location criteria
- 02Summarize inbox threads and draft replies
- 03Prepare posts for review before publishing
- 04Draft connection notes based on a person's posts
MCP support
Provides LinkedIn action tools over a hosted Streamable HTTP MCP endpoint. Clients connect using OAuth 2.1 or an Authorization Bearer API key; Sales Navigator and Recruiter tools can be enabled per workspace.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://app.curviate.com/mcpclaude mcp add --transport http com-curviate https://app.curviate.com/mcp{"mcpServers":{"com-curviate":{"type":"http","url":"https://app.curviate.com/mcp"}}}Open in Cursor{"servers":{"com-curviate":{"type":"http","url":"https://app.curviate.com/mcp"}}}Open in VS Code{"mcpServers":{"com-curviate":{"type":"http","url":"https://app.curviate.com/mcp"}}}{"mcpServers":{"com-curviate":{"serverUrl":"https://app.curviate.com/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
Details
From the project README
LinkedIn actions for AI agents, as MCP tools. One hosted URL, nothing to install.
Connect in 30 seconds
Point any MCP client that speaks remote Streamable HTTP at one URL:
https://app.curviate.com/mcp
Sign in with OAuth where the client offers it, otherwise send your Curviate API key as an Authorization: Bearer header. Your agent then has LinkedIn search, messaging, posts and connection requests as native tools. Sales Navigator and Recruiter tools are off by default and switch on per workspace, and they answer only for a connected account that holds the product: see Toolsets.
You need a Curviate workspace and one connected LinkedIn account. Full walkthrough: MCP quickstart.
Your client
Claude Code
OAuth:
claude mcp add --transport http curviate https://app.curviate.com/mcp
Then run /mcp in Claude Code, select curviate, choose Authenticate, and approve access in the browser.
API key:
claude mcp add --transport http curviate https://app.curviate.com/mcp \
--header "Authorization: Bearer $CURVIATE_API_KEY"
Your shell expands $CURVIATE_API_KEY when you run that command, so the key itself lands in Claude Code's config file. Prefer the OAuth path above unless you need a key.
Check either setup with claude mcp list: curviate reads Connected.
Details and caveats: docs.curviate.com/reference/mcp/client-setup#claude-code
Codex
OAuth:
codex mcp add curviate --url https://app.curviate.com/mcp
Codex prints an authorization URL. Open it, sign in to Curviate, and approve access. To sign in again later, run codex mcp login curviate.
API key, read from the environment each time Codex connects:
codex mcp add curviate --url https://app.curviate.com/mcp \
--bearer-token-env-var CURVIATE_API_KEY
Check with codex mcp list.
Details and caveats: docs.curviate.com/reference/mcp/client-setup#codex
Gemini CLI
OAuth:
gemini mcp add --transport http curviate https://app.curviate.com/mcp
Then start gemini, run /mcp auth curviate, open the printed URL, sign in to Curviate, and approve access.
API key:
gemini mcp add --transport http curviate https://app.curviate.com/mcp \
-H 'Authorization: Bearer ${CURVIATE_API_KEY}'
Keep the single quotes: Gemini CLI stores ${CURVIATE_API_KEY} as written and fills it from the environment when it connects, so the key stays out of the settings file.
Check with gemini mcp list: curviate reads Connected. Gemini CLI will not start MCP servers in a folder you have not trusted, where the server reads Disabled instead.
Details and caveats: docs.curviate.com/reference/mcp/client-setup#gemini-cli
Another client
Any client that speaks remote Streamable HTTP can connect. Try OAuth with the bare URL first, then the Authorization: Bearer header. A client that connects but fails tool calls with 401 is usually sending the header only on connect: see Troubleshooting.
Authentication
| Method | Use it when |
|---|---|
| OAuth 2.1 | The client supports it. Always the first choice: no key leaves the dashboard, and you revoke the client on its own under Settings, Authorized applications. |
Authorization: Bearer cvt_live_YOUR_KEY | The client can set a header but has no OAuth, or runs unattended. |
?token=cvt_live_YOUR_KEY | Last resort, for a client that can set no header. The header wins if a request carries both. |
Your API key is a full-access workspace credential: anyone holding it can act on every LinkedIn account in the workspace. Create, rotate and revoke it from the key chip in the dashboard top bar, keep it in an environment variable, and reference the variable from the client config rather than the literal key.
Full rules: Authentication.
Things to ask your agent
Find heads of engineering at Series B fintech companies in Berlin who posted about hiring in the last month.
Triage my LinkedIn inbox: summarize every thread still waiting on me, then draft a reply to each one.
Show me the five most relevant people who commented on my last post, and draft a connection request note for each referencing what they said. I will say which ones to send.
Draft a post about what we shipped this week, in my voice, and show it to me before anything goes out.
Review the Sales Navigator leads I saved this week and flag the ones who recently changed jobs.
Links
| MCP quickstart | Connect a client and make a first call |
| Client setup | Per-client commands and UI paths |
| Authentication | OAuth, the Bearer header, and ?token= |
| Toolsets | Which tools your client sees, and how to turn more on |
| Errors and limits | The error shape, rate limits, safety limits |
| Troubleshooting | 401s, a missing tool, a dropped session |
| curviate.com | What Curviate is |
| CLI | The same actions from a terminal or a shell script |
| TypeScript SDK | The same actions from your own code |
License
MIT. See LICENSE.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.