MCP Server

​

முன்நிபந்தனைகள்

• உங்கள் கணினியில் Node.js 18 அல்லது அதற்குப் பிந்தைய பதிப்பு நிறுவப்பட்டிருக்க வேண்டும்
• ஒரு Avala API key (Mission Control இல் Settings > Security பகுதியில் உருவாக்கவும்)

​

அமைப்பு

​

Claude Desktop

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "avala": {
      "command": "npx",
      "args": ["-y", "@avala-ai/mcp-server"],
      "env": {
        "AVALA_API_KEY": "your-api-key"
      }
    }
  }
}

​

Cursor

{
  "mcpServers": {
    "avala": {
      "command": "npx",
      "args": ["-y", "@avala-ai/mcp-server"],
      "env": {
        "AVALA_API_KEY": "your-api-key"
      }
    }
  }
}

​

VS Code

{
  "mcpServers": {
    "avala": {
      "command": "npx",
      "args": ["-y", "@avala-ai/mcp-server"],
      "env": {
        "AVALA_API_KEY": "your-api-key"
      }
    }
  }
}

​

Claude Code

claude mcp add avala -- npx -y @avala-ai/mcp-server

export AVALA_API_KEY="your-api-key"

​

ChatGPT

​

MCP பாதுகாப்பு முறை

AVALA_MCP_ENABLE_MUTATIONS=true

• create_dataset
• create_agent, delete_agent
• create_annotation_issue, update_annotation_issue, delete_annotation_issue
• create_storage_config, delete_storage_config
• create_webhook, delete_webhook
• create_export
• evaluate_quality
• compute_consensus
• fleet_register_device, fleet_acknowledge_alert

​

கிடைக்கும் MCP கருவிகள்

​

Fleet (முன்னோட்டம்)

​

கருவி வரையறைகள்

​

list_datasets

• dataType (string, optional) — தரவு வகை மூலம் வடிகட்டவும் (image, video, lidar, mcap, splat)
• name (string, optional) — dataset பெயர் மூலம் வடிகட்டவும் (பகுதி பொருத்தம்)
• status (string, optional) — dataset நிலை மூலம் வடிகட்டவும்
• visibility (string, optional) — தெரிவுநிலை மூலம் வடிகட்டவும் (private அல்லது public)
• limit (number, optional) — திருப்பி அனுப்ப வேண்டிய அதிகபட்ச datasets எண்ணிக்கை
• cursor (string, optional) — முந்தைய கோரிக்கையிலிருந்து pagination cursor

{
  "datasets": [
    {
      "uid": "d8f2e1a4-3b7c-4e9f-a1d6-5c8b9e0f2a3d",
      "name": "Urban Driving Q1",
      "slug": "urban-driving-q1",
      "dataType": "lidar",
      "itemCount": 12450,
      "visibility": "private",
      "status": "active",
      "createdAt": "2026-01-15T08:30:00Z"
    },
    {
      "uid": "a1b2c3d4-5e6f-7a8b-9c0d-e1f2a3b4c5d6",
      "name": "Warehouse Cameras",
      "slug": "warehouse-cameras",
      "dataType": "image",
      "itemCount": 34200,
      "visibility": "private",
      "status": "active",
      "createdAt": "2026-02-20T14:15:00Z"
    }
  ],
  "cursor": "eyJpZCI6MTAwfQ=="
}

​

get_dataset

• uid (string, required) — dataset-ன் தனிப்பட்ட அடையாளங்காட்டி (UUID)

{
  "uid": "d8f2e1a4-3b7c-4e9f-a1d6-5c8b9e0f2a3d",
  "name": "Urban Driving Q1",
  "slug": "urban-driving-q1",
  "dataType": "lidar",
  "itemCount": 12450,
  "sequenceCount": 85,
  "visibility": "private",
  "status": "active",
  "owner": "acme-robotics",
  "createdAt": "2026-01-15T08:30:00Z",
  "updatedAt": "2026-03-10T11:45:00Z"
}

{
  "error": "not_found",
  "message": "Dataset with UID 'invalid-uid-here' was not found.",
  "status": 404
}

​

list_projects

• limit (number, optional) — திருப்பி அனுப்ப வேண்டிய அதிகபட்ச projects எண்ணிக்கை
• cursor (string, optional) — முந்தைய கோரிக்கையிலிருந்து pagination cursor

​

get_project

• uid (string, required) — project-ன் தனிப்பட்ட அடையாளங்காட்டி (UUID)

​

create_dataset

• name (string, required) — dataset-ன் காட்சி பெயர்
• slug (string, required) — dataset-க்கான URL-நட்பு அடையாளங்காட்டி
• dataType (string, required) — தரவு வகை: image, video, lidar, அல்லது mcap
• isSequence (boolean, optional) — dataset sequences கொண்டதா (இயல்புநிலை: false)
• visibility (string, optional) — dataset தெரிவுநிலை: private அல்லது public (இயல்புநிலை: private)
• createMetadata (boolean, optional) — dataset metadata உருவாக்க வேண்டுமா (இயல்புநிலை: true)
• providerConfig (object, optional) — Cloud storage provider configuration
• ownerName (string, optional) — dataset owner பயனர்பெயர் அல்லது மின்னஞ்சல்

​

create_export

• project (string, optional) — export செய்ய வேண்டிய project UID
• dataset (string, optional) — export செய்ய வேண்டிய dataset UID

{
  "uid": "e3a1b2c4-9d8f-4e7a-b6c5-d4e3f2a1b0c9",
  "status": "pending",
  "project": "770a9600-a40d-63f6-c938-668877660000",
  "createdAt": "2026-03-19T10:00:00Z"
}

​

get_export_status

• uid (string, required) — export-ன் தனிப்பட்ட அடையாளங்காட்டி (UUID)

{
  "uid": "e3a1b2c4-9d8f-4e7a-b6c5-d4e3f2a1b0c9",
  "status": "completed",
  "project": "770a9600-a40d-63f6-c938-668877660000",
  "downloadUrl": "https://api.avala.ai/exports/e3a1b2c4-9d8f-4e7a-b6c5-d4e3f2a1b0c9/download",
  "fileSize": 52428800,
  "createdAt": "2026-03-19T10:00:00Z",
  "completedAt": "2026-03-19T10:02:34Z"
}

​

list_exports

• limit (number, optional) — திருப்பி அனுப்ப வேண்டிய அதிகபட்ச exports எண்ணிக்கை
• cursor (string, optional) — முந்தைய கோரிக்கையிலிருந்து pagination cursor

​

get_workspace_stats

{
  "datasets": 14,
  "projects": 7,
  "exports": 23,
  "tasks": {
    "total": 8420,
    "pending": 312,
    "completed": 7856,
    "inProgress": 252
  },
  "members": 18
}

​

list_tasks

• project (string, optional) — project UID மூலம் வடிகட்டவும்
• status (string, optional) — task நிலை மூலம் வடிகட்டவும்
• limit (number, optional) — திருப்பி அனுப்ப வேண்டிய அதிகபட்ச tasks எண்ணிக்கை
• cursor (string, optional) — முந்தைய கோரிக்கையிலிருந்து pagination cursor

{
  "tasks": [
    {
      "uid": "t1a2b3c4-d5e6-f7a8-b9c0-d1e2f3a4b5c6",
      "status": "completed",
      "project": "770a9600-a40d-63f6-c938-668877660000",
      "assignee": "jane.doe@acme.com",
      "completedAt": "2026-03-18T16:30:00Z"
    },
    {
      "uid": "t7e8f9a0-b1c2-d3e4-f5a6-b7c8d9e0f1a2",
      "status": "pending",
      "project": "770a9600-a40d-63f6-c938-668877660000",
      "assignee": null,
      "completedAt": null
    }
  ],
  "cursor": "eyJ0YXNrSWQiOjUwfQ=="
}

​

get_task

• uid (string, required) — task-ன் தனிப்பட்ட அடையாளங்காட்டி (UUID)

​

list_agents

• limit (number, optional) — திருப்பி அனுப்ப வேண்டிய அதிகபட்ச agents எண்ணிக்கை
• cursor (string, optional) — முந்தைய கோரிக்கையிலிருந்து pagination cursor

​

get_agent

• uid (string, required) — agent-ன் தனிப்பட்ட அடையாளங்காட்டி (UUID)

​

create_agent

• name (string, required) — agent-ன் பெயர்
• events (string[], required) — agent subscribe செய்யும் event வகைகளின் பட்டியல்
• callbackUrl (string, optional) — event callbacks பெற URL
• description (string, optional) — agent-ன் விளக்கம்
• project (string, optional) — agent-ஐ scope செய்ய project UID
• taskTypes (string[], optional) — agent கையாளும் task வகைகள்

​

delete_agent

• uid (string, required) — நீக்க வேண்டிய agent-ன் தனிப்பட்ட அடையாளங்காட்டி (UUID)

​

list_webhooks

• limit (number, optional) — திருப்பி அனுப்ப வேண்டிய அதிகபட்ச webhooks எண்ணிக்கை
• cursor (string, optional) — முந்தைய கோரிக்கையிலிருந்து pagination cursor

​

create_webhook

• targetUrl (string, required) — webhook deliveries பெற URL
• events (string[], required) — subscribe செய்ய வேண்டிய event வகைகளின் பட்டியல்

​

delete_webhook

• uid (string, required) — நீக்க வேண்டிய webhook-ன் தனிப்பட்ட அடையாளங்காட்டி (UUID)

​

list_storage_configs

• limit (number, optional) — திருப்பி அனுப்ப வேண்டிய அதிகபட்ச storage configs எண்ணிக்கை
• cursor (string, optional) — முந்தைய கோரிக்கையிலிருந்து pagination cursor

​

create_storage_config

• name (string, required) — storage configuration-ன் பெயர்
• provider (string, required) — storage provider வகை (s3 அல்லது gcs)
• s3BucketName (string, optional) — S3 bucket பெயர்
• s3BucketRegion (string, optional) — S3 bucket region
• s3BucketPrefix (string, optional) — S3 key prefix
• s3AccessKeyId (string, optional) — S3 access key ID (server-side-இல் பாதுகாப்பாக சேமிக்கப்படும்)
• s3SecretAccessKey (string, optional) — S3 secret access key (server-side-இல் பாதுகாப்பாக சேமிக்கப்படும்)
• s3IsAccelerated (boolean, optional) — S3 Transfer Acceleration-ஐ இயக்கவும்
• gcStorageBucketName (string, optional) — Google Cloud Storage bucket பெயர்
• gcStoragePrefix (string, optional) — Google Cloud Storage prefix
• gcStorageAuthJsonContent (string, optional) — GCS service account JSON credentials (server-side-இல் பாதுகாப்பாக சேமிக்கப்படும்)

​

test_storage_config

• uid (string, required) — சோதிக்க வேண்டிய storage config-ன் தனிப்பட்ட அடையாளங்காட்டி (UUID)

​

delete_storage_config

• uid (string, required) — நீக்க வேண்டிய storage config-ன் தனிப்பட்ட அடையாளங்காட்டி (UUID)

​

list_quality_targets

• projectUid (string, required) — project-ன் தனிப்பட்ட அடையாளங்காட்டி (UUID)
• limit (number, optional) — திருப்பி அனுப்ப வேண்டிய அதிகபட்ச quality targets எண்ணிக்கை
• cursor (string, optional) — முந்தைய கோரிக்கையிலிருந்து pagination cursor

​

evaluate_quality

• projectUid (string, required) — மதிப்பிட வேண்டிய project-ன் தனிப்பட்ட அடையாளங்காட்டி (UUID)

​

get_consensus_summary

• projectUid (string, required) — project-ன் தனிப்பட்ட அடையாளங்காட்டி (UUID)

​

compute_consensus

• projectUid (string, required) — project-ன் தனிப்பட்ட அடையாளங்காட்டி (UUID)

​

list_organizations

• limit (number, optional) — திருப்பி அனுப்ப வேண்டிய அதிகபட்ச organizations எண்ணிக்கை
• cursor (string, optional) — முந்தைய கோரிக்கையிலிருந்து pagination cursor

​

get_organization

• slug (string, required) — organization-ன் slug அடையாளங்காட்டி

​

list_slices

• owner (string, required) — owner பெயர் (பயனர் அல்லது organization slug)
• limit (number, optional) — திருப்பி அனுப்ப வேண்டிய அதிகபட்ச slices எண்ணிக்கை
• cursor (string, optional) — முந்தைய கோரிக்கையிலிருந்து pagination cursor

​

get_slice

• owner (string, required) — owner பெயர் (பயனர் அல்லது organization slug)
• slug (string, required) — slice-ன் slug

​

list_annotation_issues_by_sequence

• sequenceUid (string, required) — sequence-ன் UUID
• datasetItemUid (string, optional) — dataset item UUID மூலம் வடிகட்டவும்
• projectUid (string, optional) — project UUID மூலம் வடிகட்டவும்

​

create_annotation_issue

• sequenceUid (string, required) — sequence-ன் UUID
• toolUid (string, required) — annotation tool-ன் UUID
• problemUid (string, required) — problem type-ன் UUID
• datasetItemUid (string, optional) — dataset item UUID
• projectUid (string, optional) — project UUID
• priority (string, optional) — முன்னுரிமை நிலை: lowest, low, medium, high, highest
• severity (string, optional) — தீவிரத்தன்மை நிலை: critical, moderate
• description (string, optional) — issue விளக்கம்
• wrongClass (string, optional) — தவறான class label
• correctClass (string, optional) — சரியான class label
• objectUid (string, optional) — annotation object-ன் UUID
• shouldReAnnotate (boolean, optional) — மீண்டும் annotate செய்ய வேண்டுமா
• shouldDelete (boolean, optional) — annotation-ஐ நீக்க வேண்டுமா
• framesAffected (string, optional) — issue-யால் பாதிக்கப்பட்ட frames

​

update_annotation_issue

• sequenceUid (string, required) — sequence-ன் UUID
• issueUid (string, required) — annotation issue-ன் UUID
• status (string, optional) — நிலை: open, relabeling, in_review, completed, cant_reproduce, awaiting_feedback, no_action_taken
• priority (string, optional) — முன்னுரிமை நிலை: lowest, low, medium, high, highest
• severity (string, optional) — தீவிரத்தன்மை நிலை: critical, moderate
• description (string, optional) — புதுப்பிக்கப்பட்ட விளக்கம்
• toolUid (string, optional) — annotation tool-ன் UUID
• problemUid (string, optional) — problem type-ன் UUID
• wrongClass (string, optional) — தவறான class label
• framesAffected (string, optional) — issue-யால் பாதிக்கப்பட்ட frames

​

delete_annotation_issue

• sequenceUid (string, required) — sequence-ன் UUID
• issueUid (string, required) — நீக்க வேண்டிய annotation issue-ன் UUID

​

list_annotation_issues_by_dataset

• owner (string, required) — dataset owner பயனர்பெயர்
• datasetSlug (string, required) — dataset slug
• sequenceUid (string, optional) — sequence UUID மூலம் வடிகட்டவும்

​

get_annotation_issue_metrics

• owner (string, required) — dataset owner பயனர்பெயர்
• datasetSlug (string, required) — dataset slug
• sequenceUid (string, optional) — sequence UUID மூலம் வடிகட்டவும்

​

list_qc_tools

• datasetType (string, required) — dataset வகை (எ.கா., lidar, image, video)

​

fleet_list_devices

• status (string, optional) — device நிலை மூலம் வடிகட்டவும் (online, offline, maintenance)
• type (string, optional) — device வகை மூலம் வடிகட்டவும்
• limit (number, optional) — திருப்பி அனுப்ப வேண்டிய அதிகபட்ச devices எண்ணிக்கை
• cursor (string, optional) — pagination cursor

{
  "devices": [
    {
      "uid": "dev-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "name": "Forklift Sensor Unit 12",
      "type": "lidar-sensor",
      "status": "online",
      "firmwareVersion": "2.4.1",
      "lastSeenAt": "2026-03-19T09:55:00Z",
      "tags": ["warehouse-a", "forklift"]
    },
    {
      "uid": "dev-b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "name": "Dock Camera 3",
      "type": "camera",
      "status": "offline",
      "firmwareVersion": "1.8.0",
      "lastSeenAt": "2026-03-18T23:10:00Z",
      "tags": ["dock", "exterior"]
    }
  ],
  "cursor": "eyJkZXZpY2VJZCI6MjB9"
}

​

fleet_get_device

• uid (string, required) — device-ன் தனிப்பட்ட அடையாளங்காட்டி

​

fleet_list_recordings

• device (string, optional) — device UID மூலம் வடிகட்டவும்
• status (string, optional) — recording நிலை மூலம் வடிகட்டவும்
• limit (number, optional) — திருப்பி அனுப்ப வேண்டிய அதிகபட்ச recordings எண்ணிக்கை
• cursor (string, optional) — pagination cursor

​

fleet_get_recording

• uid (string, required) — recording-ன் தனிப்பட்ட அடையாளங்காட்டி

​

fleet_list_events

• recording (string, optional) — recording UID மூலம் வடிகட்டவும்
• device (string, optional) — device UID மூலம் வடிகட்டவும்
• type (string, optional) — event வகை மூலம் வடிகட்டவும்
• severity (string, optional) — தீவிரத்தன்மை மூலம் வடிகட்டவும்
• limit (number, optional) — திருப்பி அனுப்ப வேண்டிய அதிகபட்ச events எண்ணிக்கை
• cursor (string, optional) — pagination cursor

​

fleet_list_alerts

• status (string, optional) — alert நிலை மூலம் வடிகட்டவும் (open, acknowledged, resolved)
• severity (string, optional) — தீவிரத்தன்மை மூலம் வடிகட்டவும் (info, warning, error, critical)
• device (string, optional) — device UID மூலம் வடிகட்டவும்
• rule (string, optional) — rule UID மூலம் வடிகட்டவும்
• limit (number, optional) — திருப்பி அனுப்ப வேண்டிய அதிகபட்ச alerts எண்ணிக்கை
• cursor (string, optional) — pagination cursor

{
  "alerts": [
    {
      "uid": "alert-c3d4e5f6-a7b8-9012-cdef-123456789012",
      "status": "open",
      "severity": "warning",
      "device": "dev-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "rule": "rule-d4e5f6a7-b8c9-0123-defa-234567890123",
      "message": "Device temperature exceeded threshold (72C)",
      "createdAt": "2026-03-19T08:45:00Z"
    },
    {
      "uid": "alert-e5f6a7b8-c9d0-1234-efab-345678901234",
      "status": "acknowledged",
      "severity": "critical",
      "device": "dev-b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "rule": "rule-f6a7b8c9-d0e1-2345-fabc-456789012345",
      "message": "Device offline for more than 24 hours",
      "createdAt": "2026-03-18T09:00:00Z",
      "acknowledgedAt": "2026-03-18T10:30:00Z"
    }
  ],
  "cursor": "eyJhbGVydElkIjoxMH0="
}

​

fleet_list_rules

• enabled (boolean, optional) — இயக்கப்பட்ட நிலை மூலம் வடிகட்டவும்
• limit (number, optional) — திருப்பி அனுப்ப வேண்டிய அதிகபட்ச rules எண்ணிக்கை
• cursor (string, optional) — pagination cursor

​

fleet_register_device

• name (string, required) — device-ன் பெயர்
• type (string, required) — device-ன் வகை
• firmwareVersion (string, optional) — firmware பதிப்பு
• tags (string[], optional) — device-க்கான tags

​

fleet_acknowledge_alert

• uid (string, required) — ஒப்புக்கொள்ள வேண்டிய alert-ன் தனிப்பட்ட அடையாளங்காட்டி

​

செய்முறைகள்

​

செய்முறை 1: Dataset நிலை சோதனை

{
  "datasets": 14,
  "projects": 7,
  "exports": 23,
  "tasks": { "total": 8420, "pending": 312, "completed": 7856, "inProgress": 252 },
  "members": 18
}

உங்களிடம் 14 datasets உள்ளன. மூன்று பெரியவை:

1. Warehouse Cameras — 34,200 items (image)
2. Urban Driving Q1 — 12,450 items (lidar)
3. Parking Lot Footage — 8,900 items (video)

​

செய்முறை 2: Export மற்றும் பதிவிறக்கம்

{
  "uid": "e3a1b2c4-9d8f-4e7a-b6c5-d4e3f2a1b0c9",
  "status": "pending",
  "project": "770a9600-a40d-63f6-c938-668877660000",
  "createdAt": "2026-03-19T10:00:00Z"
}

{
  "uid": "e3a1b2c4-9d8f-4e7a-b6c5-d4e3f2a1b0c9",
  "status": "completed",
  "downloadUrl": "https://api.avala.ai/exports/e3a1b2c4-9d8f-4e7a-b6c5-d4e3f2a1b0c9/download",
  "fileSize": 52428800,
  "completedAt": "2026-03-19T10:02:34Z"
}

உங்கள் export தயாராக உள்ளது (50 MB). இங்கே பதிவிறக்கவும்: https://api.avala.ai/exports/.../download

​

செய்முறை 3: Projects முழுவதும் தர தணிக்கை

7 projects-இல் 5 அனைத்து quality targets-ஐயும் நிறைவேற்றுகின்றன. இரண்டு கவனம் தேவை:

• Sidewalk Segmentation — “Label accuracy” இலக்கு 88%-இல் (threshold: 95%)
• Fleet Camera Review — “Consensus score” இலக்கு 0.72-இல் (threshold: 0.85)

​

செய்முறை 4: Fleet device கண்காணிப்பு

Critical (1)

• Dock Camera 3 — “Device offline for more than 24 hours” (Mar 18 முதல்)

Warning (2)

• Forklift Sensor Unit 12 — “Device temperature exceeded threshold (72C)” (Mar 19 முதல்)
• Rooftop LiDAR 1 — “Low disk space (< 5%)” (Mar 19 முதல்)

​

செய்முறை 5: Annotation issue தீர்வு வரிசைப்படுத்தல்

Urban Driving Q1 — Issue Metrics நிலை அடிப்படையில்: 12 open, 5 in review, 3 relabeling, 45 completed தீவிரத்தன்மை அடிப்படையில்: 8 critical, 57 moderate முன்னுரிமை அடிப்படையில்: 2 highest, 6 high, 18 medium, 25 low, 14 lowest சராசரி மூடும் நேரம்: 4.2 மணி நேரம்

​

எடுத்துக்காட்டு prompts

List all my datasets

Show me the details of dataset "autonomous-driving-v3"

What's the status of the "Lidar QA" project?

Create an export for project 770a9600-a40d-63f6-c938-668877660000

How many exports do I have?

Show my workspace stats

List all my automation agents

Create a webhook for task.completed events pointing to https://my-server.com/hooks

Show me the quality targets for project proj_abc123

What's the consensus score summary for my annotation project?

List all organizations I belong to

Show workspace storage config list

List all online fleet devices

Show me open critical alerts across the fleet

Register a new lidar-sensor device called "Rooftop Unit 5"

​

சிக்கல் தீர்வு

​

AVALA_API_KEY அமைக்கப்படவில்லை

Error: AVALA_API_KEY environment variable is required

​

Mutation கருவிகள் தோன்றவில்லை

{
  "env": {
    "AVALA_API_KEY": "your-api-key",
    "AVALA_MCP_ENABLE_MUTATIONS": "true"
  }
}

​

npx காணப்படவில்லை அல்லது தவறான Node.js பதிப்பு

node --version  # Must be v18.0.0 or later

​

பழைய cached MCP server

npx --yes @avala-ai/mcp-server@latest

​

API key தவறானது அல்லது காலாவதியானது