Skills API

List and invoke agent skills.

List Skills

GET /api/agents/:name/skills

Response

{
  "skills": [
    {
      "name": "host_shell",
      "description": "Execute shell commands",
      "version": "1.0.0",
      "needs_network": true,
      "needs_fs_read": true,
      "needs_fs_write": true
    },
    {
      "name": "web_crawler",
      "description": "Fetch and parse web content",
      "version": "1.0.0",
      "needs_network": true
    }
  ]
}

Get Skill Details

GET /api/agents/:name/skills/:skill

Response

{
  "name": "host_shell",
  "description": "Execute shell commands on the host system",
  "version": "1.0.0",
  "run_command": "sh",
  "entrypoint": "run.sh",
  "needs_network": true,
  "needs_fs_read": true,
  "needs_fs_write": true,
  "needs_env": false,
  "usage_example": "<invoke name=\"host_shell\">[\"ls -la\"]</invoke>"
}

Invoke Skill

POST /api/agents/:name/skills/:skill/invoke

Request (Array Args)

{
  "args": ["ls", "-la", "/home/user"]
}

Request (Object Args - MCP)

{
  "args": {
    "path": "/home/user",
    "recursive": true
  }
}

Response

{
  "success": true,
  "output": "total 24\ndrwxr-xr-x  5 user user 4096 Jan 15 12:00 .\n...",
  "exit_code": 0,
  "execution_time_ms": 23
}

Error Response

{
  "success": false,
  "error": "Command failed with exit code 1",
  "output": "ls: cannot access '/nonexistent': No such file or directory",
  "exit_code": 1
}

Create Skill

POST /api/agents/:name/skills

Request

{
  "name": "my_custom_skill",
  "description": "Does something useful",
  "code": "#!/bin/bash\nread -r args\necho \"Received: $args\"",
  "language": "bash"
}

Response

{
  "success": true,
  "skill": {
    "name": "my_custom_skill",
    "description": "Does something useful",
    "created_at": "2024-01-15T12:00:00Z"
  }
}

Update Skill

PUT /api/agents/:name/skills/:skill

Request

{
  "description": "Updated description",
  "code": "#!/bin/bash\nread -r args\necho \"Updated: $args\""
}

Delete Skill

DELETE /api/agents/:name/skills/:skill

Response

{
  "success": true,
  "message": "Skill 'old_skill' deleted"
}

Install Skill from URL

POST /api/agents/:name/skills/install

Request

{
  "url": "https://github.com/user/moxxy-skills/tree/main/skills/weather",
  "name": "weather"
}

Response

{
  "success": true,
  "skill": {
    "name": "weather",
    "description": "Get weather information",
    "installed_at": "2024-01-15T12:00:00Z"
  }
}

Get Skill Source

GET /api/agents/:name/skills/:skill/source

Response

{
  "manifest": "name = \"host_shell\"\ndescription = \"...\"",
  "code": "#!/bin/bash\nread -r args\n..."
}

MCP Tools

List MCP Servers

GET /api/agents/:name/mcp/servers

Response

{
  "servers": [
    {
      "name": "filesystem",
      "status": "connected",
      "tools_count": 5
    }
  ]
}

List MCP Tools

GET /api/agents/:name/mcp/tools

Response

{
  "tools": [
    {
      "server": "filesystem",
      "name": "read_file",
      "description": "Read file contents",
      "input_schema": {
        "type": "object",
        "properties": {
          "path": {"type": "string"}
        },
        "required": ["path"]
      }
    }
  ]
}

Add MCP Server

POST /api/agents/:name/mcp/servers

Request

{
  "name": "postgres",
  "command": "mcp-postgres",
  "args": ["postgresql://user:pass@localhost/db"],
  "env": {}
}

Invoke MCP Tool

POST /api/agents/:name/mcp/invoke

Request

{
  "server": "filesystem",
  "tool": "read_file",
  "arguments": {
    "path": "/home/user/data.txt"
  }
}

Response

{
  "success": true,
  "content": [
    {
      "type": "text",
      "text": "File contents here..."
    }
  ]
}

Remove MCP Server

DELETE /api/agents/:name/mcp/servers/:server