AI Agents & MCP

Let an AI agent operate your machines directly. Folderbird runs a hosted Model Context Protocol (MCP) server, so Claude, OpenClaw, or any MCP‑capable client can list your devices, run commands, and read or write files — using the same scoped, audited API keys.

What is MCP? The Model Context Protocol is an open standard for giving AI agents tools. Connect Folderbird once and the agent automatically discovers the device tools below — no plugin to build.

Connect your agent

It's a remote (hosted) MCP server — nothing to install. Point your client at the endpoint and send your API key as a bearer token:

Endpoint:  https://folderbird.com/mcp
Header:    Authorization: Bearer fbk_live_YOUR_KEY

Claude Desktop

In claude_desktop_config.json:

{
  "mcpServers": {
    "folderbird": {
      "url": "https://folderbird.com/mcp",
      "headers": { "Authorization": "Bearer fbk_live_YOUR_KEY" }
    }
  }
}

If your client only supports local (stdio) servers, bridge it: npx mcp-remote https://folderbird.com/mcp --header "Authorization: Bearer fbk_live_YOUR_KEY"

OpenClaw

In openclaw.json, then run openclaw gateway restart:

{
  "mcp": {
    "servers": {
      "folderbird": {
        "transport": "http",
        "url": "https://folderbird.com/mcp",
        "headers": { "Authorization": "Bearer fbk_live_YOUR_KEY" }
      }
    }
  }
}

Tools

Each tool needs the matching scope on the key — the agent only sees the tools its key is allowed to use.

Tool	What it does	Scope
`list_devices`	List the devices this key can reach, with online status.	devices:read
`run_command`	Run a shell command (cmd or PowerShell) and return its output.	exec
`browse_folder`	List the folders and files in a path on a device.	browse
`read_file`	Read a text file from a device (up to 256 KB).	download
`write_file`	Write text content to a file on a device.	upload

What the agent can do

Once connected, you can ask the agent things like:

“Which of my devices are online right now?”
“On LAPTOP‑01, what's using the most disk in C:\Users\Me\Downloads?”
“Read the latest log file on the server and summarise the errors.”
“Create a notes.txt on my desktop with this checklist.”

Security

Scoped — a key that lacks exec simply won't expose run_command.
Device‑bound — bind a key to specific machines so an agent can never touch the rest.
Rate‑limited — per‑key limits protect your devices from runaway loops.
Audited — every command an agent runs is logged with the key, device, and time on your keys page.

Tip: give each agent its own key with the narrowest scopes and device set it needs. Revoke it anytime — the agent stops instantly.

Other connectors

Not using MCP? The same capabilities are available over plain HTTP for n8n (HTTP Request node), webhooks, and custom scripts — see the API Reference.