JoinLayer — Claude Code MCP server: pipelines via OAuth
Wires your agent to the hosted JoinLayer gateway so it can read workspaces, connections and pipelines after a browser OAuth sign-in.
claude mcp add --transport http mcp https://mcp.joinlayer.app/mcpWhat JoinLayer does
JoinLayer ships as a remote MCP server at https://mcp.joinlayer.app/mcp, plus the joinlayer-pipelines skill, plugin metadata and starter prompts. The server is listed in the official MCP Registry as app.joinlayer/mcp.
Sign-in runs through browser OAuth Authorization Code with PKCE. Do not mint or paste a bearer token by hand; connection credentials belong in JoinLayer browser setup sessions and never in tool arguments. Tokens are short-lived and audience-bound.
You need an MCP client that can do OAuth. The skill installs on its own, but it carries no credentials and does not replace the MCP connection — point your client at the same hosted endpoint first. The repo includes a gateway snapshot for security review, though it is not a self-hosted distribution: it leans on a private control-plane contract that is not published.
What it helps with
- see which pipelines already exist in a workspace
- check granted OAuth scopes and capacity
- review source connections without editing configs
- plan a replication or realtime backfill run
- trace why a pipeline stalled and find a recovery point
Example prompts for the agent
- Use $joinlayer-pipelines. Inspect my workspace, scopes, capacity, connections and pipelines. Change nothing.
- List the pipelines that are running now and explain what each one does.
- Show my source connections and their status, read-only.
How to install JoinLayer
Platform CLI: remote server
claude mcp add --transport http mcp https://mcp.joinlayer.app/mcpPlatform CLI: remote server
codex mcp add joinlayer --url https://mcp.joinlayer.app/mcpConfig file
{
"mcpServers": {
"joinlayer": {
"url": "https://mcp.joinlayer.app/mcp"
}
}
}Config file
{
"servers": {
"joinlayer": {
"type": "http",
"url": "https://mcp.joinlayer.app/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http joinlayer https://mcp.joinlayer.app/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about JoinLayer
How do I install JoinLayer in Claude Code?
Add the marketplace with claude plugin marketplace add joinlayer/agent-toolkit, then install the plugin with claude plugin install joinlayer@joinlayer --scope user and run claude mcp login joinlayer. Finish the browser OAuth when prompted.
What does JoinLayer do?
It gives an agent access to JoinLayer workspaces, connections and pipelines through a hosted MCP server. The plugin also brings the joinlayer-pipelines skill with operating guidance for common tasks.
Do I need to create an access token myself?
No. Authentication uses browser OAuth with PKCE, and you should not add an Authorization header or a client secret. Connection credentials are entered only in JoinLayer browser setup sessions.
