---
title: "AI Connector Tools"
sidebarTitle: "AI Connector Tools"
description: "Reference for the tools, prompts and resources of the deeepSpace AI Connector (MCP server): what each one returns and the inputs it takes."
keywords: "deeepspace mcp tools, ai connector reference, fetch-tokens, fetch-code-mappings, fetch-component-differences"
icon: "wrench"
---

Your AI agent calls these tools by itself while it works; you don't call them directly. This page lists what each one gives the agent. To connect a tool, see [Connect your AI agent](/guides/ai-connector).

All tools are **read-only** and only return what your deeepSpace account can open. Most take a project UUID: see [Find your project](/guides/ai-connector#find-your-project).

## Design and code

| Tool | What it returns | Inputs |
|------|-----------------|--------|
| `fetch-code-mappings` | Every Figma component of a project with the code component linked to it (name, source file, export name), or nothing when it isn't linked yet. `sharedWith` lists other design components built by the same code component. | `uuid` (project) |
| `fetch-component-differences` | The latest design vs code comparison of one Figma component: its linked code component, overall score, and per variant its status, score, how it was rendered (Figma property → code prop) and its differences (severity, element, property, design value vs code value). `state` is `READY` when results exist; otherwise it says what's missing (`NOT_LINKED`, `NOT_COMPARED`, `COMPARING`…). | `componentId` (design component), `variant` (optional: one variant, for example `Size=Large, State=Default`), `includeMinor` (optional: include low-severity notes, default `false`) |
| `fetch-components` | The components of a project: name, slug and latest version. | `uuid` (project) |
| `fetch-component` | One component version in full: design data, variants, thumbnail, creator. Takes the **version** UUID (`version.uuid` from `fetch-components`, or `figmaComponent.versionUuid` from `fetch-code-mappings`), not the component id. | `uuid` (component version) |
| `search-components` | Components of a project matching a name or keyword. | `uuid` (project), `query` |
| `fetch-component-comments` | Comments on a component or asset, paginated. | `componentId` or `assetId`, `size` (optional, default 10, max 100), `page` (optional) |

## Design tokens

| Tool | What it returns | Inputs |
|------|-----------------|--------|
| `fetch-tokens` | The tokens synced from Figma variables and effect styles: spacing, radius, sizes, border widths, opacity, font sizes and weights, line heights, letter spacing, and shadows with ready-to-use CSS. Each variable has its value in every mode and the variable it points to when it's an alias. | `uuid` (project), `kind` (optional: `spacing`, `radius`, `size`, `borderWidth`, `opacity`, `fontSize`, `fontWeight`, `lineHeight`, `letterSpacing`, `other` or `shadow`) |
| `fetch-colors` | The color tokens of the project's style guide. | `uuid` (project) |
| `fetch-typography` | The typography tokens of the project's style guide. | `uuid` (project) |
| `get-style-guide-versions` | The style guide's version history, with its colors and typography. | `uuid` (project), `version` (optional) |
| `fetch-design-system` | The layout values deeepSpace derived from the project's components (spacing, radius, border width and sizing found in them, grid, breakpoints, container, content). For the tokens defined in Figma, use `fetch-tokens`. | `projectUuid` |
| `get-project-layout` | Layout values derived from components, for older projects. | `uuid` (project) |

## Projects and workspaces

| Tool | What it returns | Inputs |
|------|-----------------|--------|
| `get-current-user` | Your deeepSpace profile, workspaces, projects and settings. | None |
| `fetch-all-workspaces` | Your workspaces, with plan and status. | None |
| `get-all-projects` | The projects of one workspace, with an optional name filter. | `workspaceId`, `query` (optional), `skip` and `take` (optional pagination, `take` max 100) |
| `search-projects` | Projects of a workspace matching a name. | `workspaceId`, `query`, `skip` and `take` (optional) |
| `fetch-project-info` | A project's name, status, settings and dates. | `uuid` (project) |
| `fetch-project-versions` | All versions of a project. | `uuid` (project) |
| `fetch-project-generation-preferences` | The project's code generation settings: framework, language, styling. | `projectUuid` |
| `fetch-collections` | The project's collections (groupings of components, colors, typography, assets). | `projectUuid` |
| `fetch-assets` | The project's images, icons and other media. | `projectUuid` |
| `fetch-project-folder-structure` | The generated file and folder structure, from the components' Git paths. | `projectUuid` |

## Git repository

| Tool | What it returns | Inputs |
|------|-----------------|--------|
| `fetch-connected-repository` | The Git repository connected to the project. | `projectUuid` |
| `fetch-repository-tree` | Files and folders of the connected repository. | `projectUuid`, `path` (optional, default the root), `branch` (optional, default the repository's default branch) |
| `fetch-repository-file-content` | The contents of one file of the connected repository. | `projectUuid`, `path`, `branch` (optional) |
| `get-git-connections` | The Git services connected to your account. | None |

## Connection

| Tool | What it returns | Inputs |
|------|-----------------|--------|
| `health` | Whether the connection to deeepSpace and its services works. | None |
| `deeep-connect` | Chat sign-in only: emails you a 6-digit code. Available when the client sends `X-Deeep-Login: chat`. | `email` |
| `deeep-verify` | Chat sign-in only: checks the code and keeps the login for this session. | `email`, `code` |

## Prompts

| Prompt | What it does |
|--------|--------------|
| `implement-component` | Builds a component of a deeepSpace project with its design tokens, colors and typography instead of hard-coded values. |
| `check-design-drift` | Compares a project's design components with their linked code and lists what differs. |

## Resources

| Resource | Contents |
|----------|----------|
| `user://me` | Your deeepSpace profile. |
| `git://status` | Your Git connections and their status. |
| `components://{uuid}/catalog` | The components of a project. |
| `project://{uuid}/info` | A project's details and settings. |
| `design-system://{uuid}/tokens` | A project's design tokens in one snapshot: colors, typography, Figma number variables and shadows (as `fetch-tokens` returns them). |
| `config://app` | The AI Connector's configuration. |