# Syncthing MCP for AI Agents AI Agent Connect

> Syncthing MCP. Connect your P2P file synchronization network to your AI agent to monitor device connections, browse remote directories, and control sync folders directly from your chat. See real-time connection stats, folder progress, and system health without switching tabs. It's the fastest way to manage your distributed data infrastructure and verify that your backups are actually moving.

## Overview
- **Category:** loved-by-devs
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_N0CLhrm9KPxrQ41Ngv7EMN3DGXlbo3kn8fgArdhC/ai-agent-connect
- **Tags:** file-synchronization, p2p, data-backup, file-management, remote-access, distributed-storage

## Description

When you're managing a distributed network of folders, jumping between the web UI and your terminal is a chore. This Connector changes that by bringing your Syncthing instance directly into your AI client. Instead of hunting for specific device IDs or digging through nested menus to see if a backup finished, you just ask. You can see which nodes are online, check if a specific folder is caught up, or trigger a manual scan of a directory while you're busy with other tasks. It turns your file synchronization setup into a conversational interface where you can verify file structures across your network or pause specific syncs on the fly. It's part of the Vinkius catalog, making it easy to plug into your existing workflow. Whether you're verifying that a massive photo library actually landed on your NAS or you need to quickly check the health of a remote sync node, you get immediate answers without the context switching. It's about having a bird's eye view of your private data infrastructure while keeping your hands on the keyboard. You can move from checking a connection to auditing your entire global configuration in seconds, ensuring that your P2P network behaves exactly how you want it to.

## Tools

### system_browse
List directories matching a specific path to see your remote file structure. This helps you verify that files moved correctly to the right spot.

### system_shutdown
Shut down the Syncthing instance completely. Use this to turn off the sync service when you're done.

### system_connections
Get a list of all configured devices and see their current connection status. You can quickly identify which nodes are offline.

### get_db_completion
Check the progress percentage of a folder or device's database sync. This tells you exactly how much data is left to move.

### get_db_file
Get detailed metadata and data about a specific file in your sync network. Use this to see specific file properties.

### scan_db
Request an immediate manual scan of a specific folder to update the index. This forces Syncthing to look for new files right now.

### get_db_status
Retrieve the current database status for a synchronized folder. Use this to check if the folder index is healthy.

### get_device_stats
Get detailed performance and connection statistics for a specific device. This provides a deeper look at how a node is performing.

### get_events
Poll the system for recent synchronization events. This lets you see the latest activity in the sync log.

### get_folder_stats
Retrieve statistics like file counts and sizes for a specific folder. Use this to get a high-level summary of your synced data.

### get_config
Fetch the entire system configuration for your Syncthing instance. This is useful for auditing your current settings.

### get_db_ignores
See the specific ignore patterns currently set for a folder. This helps you understand what files are being skipped.

### get_device
Get the configuration details for a specific device. Use this to see the settings for a single node.

### get_devices
List all configured devices in your sync network. This gives you a quick overview of your entire peer network.

### get_folder
Get the configuration details for a specific folder. Use this to see the settings for a single sync directory.

### get_folders
List all configured folders in your sync network. This shows you every directory you currently have set up for sync.

### get_health
Perform a simple health check to see if the instance is responding. This is a quick way to verify the Connector connection is active.

### system_pause
Pause synchronization for all devices or a specific one by ID. This stops data transfer immediately to save bandwidth.

### get_random_string
Generate a strong random alphanumeric string for configuration. Use this to create secure keys or unique identifiers.

### system_reset
Reset the index database for a specific folder or the whole system. Use this if your folder index becomes corrupted or out of sync.

### get_restart_required
Check if the system needs a restart to apply configuration changes. This prevents you from making changes that won't take effect.

### system_restart
Restart the Syncthing process to apply updates or changes. This reboots the sync engine to refresh the configuration.

### system_resume
Resume synchronization for all devices or a specific one by ID. This restarts the data flow after it was paused.

### set_config
Replace the entire system configuration with a new set of parameters. Use this to push a complete configuration update.

### set_db_ignores
Update the ignore patterns for a specific folder. This lets you change which files are skipped during the sync.

### system_status
Get the current system status and resource usage metrics. This shows you how much CPU and memory the sync engine is using.

### verify_device_id
Verify and format a device ID to ensure it's valid. Use this to check if a device ID is correctly formatted for use.

### system_version
Get the current version of the Syncthing instance. This is useful for checking if you're running the latest software.

## Prompt Examples

**Prompt:** 
```
Are all my devices connected?
```

**Response:** 
```
I've checked your device connections. Here is the current status:

| Device Name | Status | Connection Info |
| :--- | :--- | :--- |
| **Laptop-Main** | ✅ Connected | 192.168.1.15 |
| **Backup-NAS** | ✅ Connected | 192.168.1.20 |
| **Phone-Sync** | ❌ Disconnected | Unknown |

Your primary backup nodes are online and ready.
```

**Prompt:** 
```
Is the 'Work_Backup' folder finished syncing?
```

**Response:** 
```
I've checked the database for the **Work_Backup** folder.

*   **Status:** In Progress
*   **Completion:** 84%
*   **Remaining:** 12.4 GB

It's moving along steadily. I can trigger a manual scan if you think it's stuck.
```

**Prompt:** 
```
Show me what's inside the 'Backups/2024' folder on the NAS.
```

**Response:** 
```
I've browsed the remote path on your NAS. Here are the subdirectories found:

*   `Jan_Photos`
*   `Feb_Photos`
*   `Archive_Logs`

Would you like me to check the stats for any of these specific folders?
```

## Capabilities

### Check connection status
See which devices in your network are currently online or offline.

### Monitor sync progress
Get the exact completion percentage for any folder currently being synchronized.

### Control sync states
Pause or resume synchronization for specific devices or the entire system.

### Browse remote directories
Look into remote paths to verify that files are where they should be.

### Fetch system stats
Retrieve real-time resource usage and folder statistics from your nodes.

### Trigger manual scans
Request an immediate scan of a folder to update the sync index.

## Use Cases

### Verifying remote node connectivity
A sysadmin needs to know if a remote node is online. They ask the agent to list all devices and check connections using system_connections.

### Checking large backup progress
A user wants to see if a multi-gigabyte photo backup finished. They ask the agent for the completion status of the 'Photos' folder using get_db_completion.

### Auditing remote directory paths
A data manager needs to verify a file exists on a NAS. They use system_browse to check the remote path for specific subdirectories.

### Quickly pausing data flow
A user wants to stop sync on a laptop to save battery. They tell the agent to pause the 'Laptop' device using system_pause.

### Verifying configuration changes
A user needs to see if a config change worked. They use get_restart_required to see if the system needs a reboot to apply the new settings.

## Benefits

- Stop switching tabs by checking device connection status with system_connections directly in your chat. You can see which nodes are online or offline instantly without opening a browser.
- Monitor backup progress accurately using get_db_completion to see exactly how much of a folder is synced. This gives you a clear percentage of your progress in real time.
- Manage sync states instantly with system_pause and system_resume to stop data flow on specific nodes. This is perfect for saving bandwidth or battery when you're on the move.
- Verify remote file structures quickly by using system_browse to peek into directories on other devices. You can confirm files reached their destination without manual logins.
- Audit your entire setup by fetching the full system configuration with get_config for a complete overview. This makes it easy to verify your global sync settings in one go.
- Keep your index fresh by triggering a manual folder update with scan_db whenever files go missing. This ensures your AI agent always has the most current view of your data.

## How It Works

The bottom line is you get a conversational dashboard for your P2P file synchronization network.

1. Add your Syncthing Web UI URL and API Key to your client settings.
2. Ask your agent to list your devices or check a folder's progress.
3. Get real-time stats and control your P2P network via natural language.

## Frequently Asked Questions

**Can the Syncthing MCP help me see if my remote backups are online?**
Yes, it provides a real-time view of all your configured devices. You can ask the agent to list your connections to see which nodes are active and which ones have dropped off.

**How do I check if a specific folder has finished syncing?**
You can just ask the agent for the completion status of any folder. It will pull the latest data from your sync database and tell you exactly how much progress has been made.

**Can I use the Syncthing MCP to pause sync on one device?**
Yes, you can pause or resume synchronization for specific devices by name or ID. This is helpful if you need to save bandwidth or battery life on a particular machine.

**Does the Syncthing MCP let me see the folder contents on other machines?**
Yes, it can browse remote directories. This allows you to verify that your files have actually landed on your remote nodes without having to log into those machines separately.

**Can I use this to check my Syncthing version and resource usage?**
Yes, the Connector can pull your current system version and resource usage metrics. This helps you monitor the health and performance of your sync instance.

**How do I see what files are being ignored in my sync?**
You can ask the agent to show the ignore patterns for any folder. It will list the specific rules currently set to skip certain files during the synchronization process.

**How can I check if Syncthing needs a restart after I changed the configuration?**
You can use the `get_restart_required` tool. It will return a boolean indicating if a restart is pending due to configuration changes.

**Is it possible to pause synchronization for a specific device using the AI?**
Yes. Use the `system_pause` tool and provide the specific Device ID. If you omit the ID, it will pause all devices.

**Can I see which files are currently being synchronized?**
You can use `get_db_status` or `get_db_completion` for a specific folder to see the synchronization progress and state of the files in that directory.