How to Use the Assembly MCP in Claude Code

Q: Can Claude Code export Assembly clients to a file?

Yes. You can instruct the agent to run listclients, grab the details with getclient, and write the output to a local CSV or JSON file right from your terminal.

Pipe Assembly workspace data directly into your terminal scripts with Claude Code.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Assembly MCP to Claude Code

Create your Vinkius account to connect Assembly to Claude Code and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Assembly with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Headless Assembly Operations

This server lets you query your Assembly organizational structure right from the command line. You tell Claude Code to audit active accounts, and it fires `list_companies` followed by `get_company` to print a formatted summary to stdout. You can wrap this in a bash script or a cron job. The agent fetches the exact JSON payload via `list_clients` and parses it based on your prompt. No browser required.

Automate Workspace Audits

This integration replaces custom Python scripts by letting Claude Code audit your Assembly environments natively. You just ask your terminal to check the status, and the agent runs `list_workspaces` to grab the IDs. It iterates through them with `get_workspace` automatically. It handles the same process for your team roster. A quick prompt triggers `list_users` and `get_user` to verify permissions across the board. You get the results piped directly into your SSH session.

A Terminal-Native MCP Server

This Assembly MCP Server feeds raw workspace data directly to Claude Code for CI/CD pipelines. If your deployment script needs configuration details, the agent pulls them via `list_notes` and `get_note` automatically. You configure the connection once. From there, the agent translates your plain English commands into precise API calls. It extracts the exact client or company record you need without any manual formatting.

Setup guide

Set up Assembly MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see assembly-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest Assembly transactions." It will automatically discover and invoke the available Assembly tools.

Terminal

claude mcp add --transport http assembly-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
2

Add the Assembly MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "assembly-mcp": {
      "type": "url",
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Assembly. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Assembly now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Assembly MCP in Claude Code

Run claude mcp add --transport http vinkius-assembly -- . Make sure you put all flags before the server name. You can verify the installation by typing claude mcp list.

Yes. You can instruct the agent to run `list_clients`, grab the details with `get_client`, and write the output to a local CSV or JSON file right from your terminal.

It runs perfectly in automated pipelines. Since Claude Code operates entirely in the CLI, it can fetch Assembly workspaces or notes during a GitHub Action without any human interaction.

You get full read access to your core records. The agent can execute list and get commands for companies, users, notes, clients, and workspaces directly from your shell prompt.

Your client lists, company profiles, and private notes remain secure. Vinkius handles the authentication and runs the MCP Server in an isolated V8 sandbox that spins down immediately after the CLI request finishes.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript