Spaces:
Sleeping
Sleeping
File size: 1,455 Bytes
13320e1 cd8cdcc |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 |
# CleanCity Agent - MCP Server API Documentation
This document describes the **Model Context Protocol (MCP) tools** exposed by CleanCity Agent's MCP server.
## 🔌 Server Information
- **Server Name:** `cleancity-agent`
- **Version:** 1.0.0
- **Protocol:** MCP (Model Context Protocol)
- **Transport:** stdio
## 🛠️ Available Tools
CleanCity Agent exposes **6 powerful tools** that AI agents can use to detect trash, plan cleanups, track events, and generate reports.
---
## 1. `detect_trash`
Analyze an image and detect trash/litter using computer vision.
### Input Schema
```json
{
"image_path": "string (required)",
"location": "string (optional)",
"notes": "string (optional)"
}
```
### Parameters
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `image_path` | string | ✅ Yes | Absolute path to image file on disk |
| `location` | string | ❌ No | Location where trash was found (e.g., "Central Park") |
| `notes` | string | ❌ No | Additional context or observations |
### Returns
```json
{
"detections": [
{
"object_type": "plastic_bottle",
"confidence": 0.95,
"bbox": [100, 150, 250, 400]
}
],
"count": 5,
"annotated_image_path": "/path/to/annotated_image.jpg"
}
```
### Example Usage
**Claude Desktop:**
```
User: Analyze the trash in /home/user/beach_litter.jpg at Ocean Beach |