How to integrate Zeplin MCP with Atomic Agent

Connect Atomic Agent to Zeplin MCP. List all project styleguides in zeplin, get all screens for a specific project, and more using natural language, with authentication handled for you.

Zeplin logoZeplin
Oauth2Api Key

Zeplin is a collaborative workspace for designers and developers to organize and hand off design projects. It streamlines design file sharing and communication for smoother product development.

24 Tools

Introduction

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,700+ apps through Composio, including Zeplin.

This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Zeplin account. See the Atomic Agent documentation for installation instructions.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Zeplin with

How Atomic Agent connects to Zeplin

Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.

Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

Connect Zeplin to Atomic Agent

  1. Sign up or sign in to the Composio dashboard. Copy your API key.
  2. In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
  3. Ask Atomic Agent to do something in Zeplin. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your Zeplin account, then return to Atomic Agent to continue.

Headless setup

Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

bash
COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY

What is the Zeplin MCP server, and what's possible with it?

The Zeplin MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Zeplin account. It provides structured and secure access to your Zeplin workspace, so your agent can perform actions like listing projects, fetching screens, exporting assets, managing components, and collaborating with your design team on your behalf.

  • Project and styleguide management: Let your agent list, fetch, or organize your Zeplin projects and associated styleguides for faster design handoff and reference.
  • Screen and asset retrieval: Automatically pull screen details, preview images, or export assets from any project directly into your workflow, no copy-paste required.
  • Component library access: Have your agent fetch, list, or update components from your shared libraries to keep your design system in sync.
  • Commenting and collaboration: Enable your agent to read, create, or manage comments on screens or components, streamlining feedback and design review cycles.
  • Resource linking and metadata extraction: Allow your agent to extract, organize, or provide direct links to design resources and metadata, making documentation and developer handoff seamless.

Use Zeplin from Atomic Agent

With your account connected, ask Atomic Agent to work with Zeplin in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.

Troubleshooting

Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See Composio pricing for the current limits that apply to your connection.

TOOLS

Supported Tools

Every Zeplin action and event your agent gets out of the box.

Start OAuth authorization (PKCE)

Construct an OAuth 2.0 authorization URL for a Zeplin app to initiate the authorization code flow.

List Project Connected Components

List connected components in a Zeplin project by project ID.

List Project Colors

List colors defined in a Zeplin project by project ID, for example to retrieve its color tokens.

Update Project Color

Tool to update a color in a Zeplin project.

Get Zeplin Project by ID

Get a Zeplin project by ID to view details about a specific project.

Invite Project Member

Invite a user to a Zeplin project by handle, with an optional role.

List Project Text Styles

List text styles in a Zeplin project by project ID to retrieve its typography tokens.

Update Project Text Style

Update an existing text style in a Zeplin project by project and text style IDs.

Delete Screen Annotation

Tool to delete a screen annotation in Zeplin.

Get Screen Annotation

Tool to fetch a single screen annotation.

List Screen Annotations

List a page of annotations for a Zeplin screen by screen ID.

Update Screen Annotation

Update a screen annotation's content, position, or type by screen and annotation IDs.

List Screen Components

List components in a Zeplin screen by screen ID.

Get Screen Section

Tool to get a single screen section.

List Screen Sections

List screen sections in a Zeplin project by project ID.

Get Screen Version

Retrieve a specific Zeplin screen version by screen and version IDs to inspect its snapshot metadata.

Create Screen Version

Tool to create a new version of a screen.

List Screen Versions

List a page of versions for a Zeplin screen to enumerate its past snapshots.

Create Styleguide Color

Create a color token in a Zeplin styleguide.

List Styleguide Colors

List color tokens in a Zeplin styleguide by styleguide ID.

Update Styleguide Color

Update a color in a Zeplin styleguide.

List Styleguide Text Styles

List a page of text styles in a Zeplin styleguide to retrieve its typography tokens.

Update Styleguide Text Style

Update typography settings of a text style in a Zeplin styleguide.

List Personal Projects

List a page of projects in the current user's personal workspace.

FAQ

Frequently asked questions

Start with Zeplin.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Zeplin tool your agent needs.Free to start.

Start building