---
title: "SMBAct for AI agents: MCP server and agent skills"
description: Let Claude Code, Codex, Cursor or Copilot arrange your windows on macOS, Windows and Linux with SMBAct's local MCP server and open-source agent skills.
canonical: https://smblob.com/products/smbact/ai-agents/
date: 2026-11-16
locale: en
---

# SMBAct for AI agents: MCP server and agent skills

> Markdown version of https://smblob.com/products/smbact/ai-agents/
> Same content as the HTML page without navigation, styling or scripts. Cite the HTML URL.
> Site structure and the full page list for agents: https://smblob.com/llms.txt

Let Claude Code, Codex, Cursor or Copilot arrange your windows on macOS, Windows and Linux with SMBAct's local MCP server and open-source agent skills.

[SMBAct](https://smblob.com/products/smbact/) › AI agents

## SMBAct for AI agents

Tell your AI agent “editor on the left two thirds, terminal on the right” and the windows move. SMBAct, the window manager for macOS, Windows and Linux, gives AI agents two things:

- **A local [MCP server](https://smblob.com/products/smbact/ai-agents/mcp-server/)** built into the app. Any MCP client (Claude Code, Codex, Cursor, VS Code, Claude Desktop…) can list your windows and arrange them with SMBAct’s layouts.
- **[Agent skills](https://smblob.com/products/smbact/ai-agents/agent-skills/)**, free and open source on [GitHub](https://github.com/GigLaboCom/smbact-skills). They teach the agent how to use that server well: look before it moves anything, leave its own terminal alone, ask before closing, and report what really happened.

[![](https://smblob.com/docs/smbact/ai-agents/agent-mac-poster.jpg)](https://files.smblob.com/smbact/ai-agents/agent-mac.mp4)

A real run on macOS: the MCP client asks for the slides on the left two thirds, the film top right and its own terminal under it. SMBAct answers one `list_windows` call and three `window_action` calls. The same request on [Windows and KDE Plasma](https://smblob.com/products/smbact/ai-agents/mcp-server/#see-it-on-every-platform).

## How it fits together

![Diagram: your request goes to an AI agent with SMBAct agent skills, which calls SMBAct's MCP server on 127.0.0.1; SMBAct's window engine moves the windows through macOS Accessibility, Win32, X11 or the GNOME and KDE Wayland plugins](https://smblob.com/docs/smbact/ai-agents/ai-agents-flow.webp)

The agent (and the AI model behind it) decides what to do. The skills are plain text it reads first. The MCP server runs inside SMBAct on your computer and does the moving with the same engine as SMBAct’s hotkeys, switcher and command line. SMBAct sends nothing to a cloud service of its own.

## MCP server or agent skills: which do I need?

||[MCP server](https://smblob.com/products/smbact/ai-agents/mcp-server/)|[Agent skills](https://smblob.com/products/smbact/ai-agents/agent-skills/)|
|-|-|-|
|What it is|Tools: `list_windows`, `window_action`, `focus_window`…|Instructions: which tool, in what order, what never to do|
|Where it lives|Inside SMBAct (MCP server page in the sidebar)|A Claude Code plugin or a skills folder, from GitHub|
|Works alone|Yes, with any MCP client or a script|No: the skills act through the MCP server|
|Cost|Included in SMBAct (trial or license)|Free, MIT license|

- **You use Claude Code, Codex, Cursor, GitHub Copilot or Gemini CLI:** turn on the MCP server and add the skills. The server makes window management possible; the skills make the agent careful and predictable with it.
- **You use another MCP client, or write your own script:** the MCP server is enough. Its tool descriptions say what each tool does.
- **You only want hotkeys:** you need neither. Both are optional, and the MCP server is off until you turn it on.

## What you can ask

- “Put Chrome on the left half and Slack on the right.”
- “Send the terminal to the other monitor.” “Bring the browser to the front.”
- “Minimize everything.” (only when you say so)
- “Why doesn’t my client see SMBAct?” (the skills run a read-only check)

With the next SMBAct update the agent also places windows at exact sizes (“Safari 60 % wide on the left”, “a 3×2 grid”), saves and restores whole layouts, and moves windows between macOS desktops. The [full list of requests](https://smblob.com/products/smbact/ai-agents/agent-skills/#what-you-can-ask) shows what works today and what comes with the update.

## Platforms

||How the agent connects|Notes|
|-|-|-|
|**macOS** (Apple Silicon, Intel)|`smbact-cli mcp serve` (stdio, no token) or HTTP|`smbact-cli` ships inside SMBAct.app. [Install guide](https://smblob.com/products/smbact/documentation/install-macos/)|
|**Windows** (x64)|HTTP `127.0.0.1:5057` with an access token|[Install guide](https://smblob.com/products/smbact/documentation/install-windows/)|
|**Linux** (x64)|HTTP `127.0.0.1:5057` with an access token|X11, plus [GNOME](https://smblob.com/products/smbact/documentation/gnome-wayland/) and [KDE Plasma](https://smblob.com/products/smbact/documentation/kde-plasma-wayland/) on Wayland, where `wmctrl` and `xdotool` cannot move windows|

`smbact-cli` for Windows and Linux is on the [roadmap](https://smblob.com/products/smbact/roadmap/); until then those systems use the HTTP connection, which offers the same tools.

## Price

MCP tool calls work during SMBAct’s 14-day trial (every feature included) and with a license, a one-time purchase from €14.99 ([prices](https://smblob.com/products/smbact/#pricing)). Without either, clients can connect, but tool calls are refused. The agent skills are free.

## Read next

- [SMBAct MCP server](https://smblob.com/products/smbact/ai-agents/mcp-server/): turn it on, connect Claude Code, Cursor, Codex or Claude Desktop, the tools and the guard rails.
- [SMBAct agent skills](https://smblob.com/products/smbact/ai-agents/agent-skills/): what a skill is, how it changes the agent’s behaviour, the six skills and how to install them.
- [smbact-skills on GitHub](https://github.com/GigLaboCom/smbact-skills): the skills, the plugin and their generated references.
- [Download SMBAct](https://smblob.com/products/smbact/download/) · [Documentation](https://smblob.com/products/smbact/documentation/)

## Pages in this section

- [SMBAct agent skills for Claude Code, Codex and Cursor](https://smblob.com/products/smbact/ai-agents/agent-skills/): Free, open-source Agent Skills that teach Claude Code, Codex, Cursor and Copilot to arrange windows with SMBAct: list first, dry run, ask before closing.
- [SMBAct MCP server for Claude Code, Cursor and Codex](https://smblob.com/products/smbact/ai-agents/mcp-server/): SMBAct's local MCP server lets Claude Code, Cursor, Codex and other MCP clients list, tile, focus and close windows on macOS, Windows and Linux. Setup and tools.

## Related

- HTML version of this page: https://smblob.com/products/smbact/ai-agents/
- Site map for agents: https://smblob.com/llms.txt
