Curviate MCP README

Curviate

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:

Code

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:

Terminal

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:

Terminal

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:

bash

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:

bash

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:

bash

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:

bash

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

Code

Find heads of engineering at Series B fintech companies in Berlin who posted about hiring in the last month.

Code

Triage my LinkedIn inbox: summarize every thread still waiting on me, then draft a reply to each one.

Code

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.

Code

Draft a post about what we shipped this week, in my voice, and show it to me before anything goes out.

Code

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.