Tools Reference

This page documents all tools provided by the @skillzmarket/mcp server.

skillz_search

Search the Skillz Market for skills by name or description.

Input Schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search query"
    },
    "category": {
      "type": "string",
      "description": "Filter by category (optional)"
    },
    "group": {
      "type": "string",
      "description": "Filter by group slug (optional)"
    }
  },
  "required": ["query"]
}

Example

Prompt: "Search Skillz Market for image generation skills"

Response:

[
  {
    "slug": "text-to-image",
    "name": "Text to Image",
    "description": "Generate images from text prompts",
    "price": "0.01",
    "currency": "USDC"
  }
]

skillz_info

Get detailed information about a specific skill including price, endpoint, and input/output schemas.

Input Schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Skill slug (unique identifier)"
    }
  },
  "required": ["slug"]
}

Example

Prompt: "Get info about the text-to-image skill"

Response:

{
  "id": "abc123",
  "slug": "text-to-image",
  "name": "Text to Image",
  "description": "Generate images from text prompts using DALL-E",
  "price": "0.01",
  "currency": "USDC",
  "endpoint": "https://example.com/api/text-to-image",
  "inputSchema": {
    "type": "object",
    "properties": {
      "prompt": { "type": "string" },
      "style": { "type": "string" }
    },
    "required": ["prompt"]
  },
  "paymentAddress": "0x...",
  "isActive": true
}

skillz_call

Call a skill with automatic USDC payment on Base network.

Requires: Configured wallet via SKILLZ_PRIVATE_KEY

Input Schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Skill slug"
    },
    "input": {
      "type": "object",
      "description": "Input data for the skill"
    }
  },
  "required": ["slug", "input"]
}

Example

Prompt: "Call text-to-image with prompt 'A cyberpunk cityscape at night'"

Response:

{
  "imageUrl": "https://example.com/generated/abc123.png",
  "prompt": "A cyberpunk cityscape at night"
}

Payment Flow

The tool fetches skill info to get the price
Creates a USDC transfer on Base network
Signs and submits the transaction
Includes payment proof in the skill request
Returns the skill result

Error Handling

If no wallet is configured:

Error: No wallet configured. Set SKILLZ_PRIVATE_KEY environment variable.

If the call fails:

Error calling skill: [error message]

skillz_reviews

Get reviews for a specific skill.

Input Schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Skill slug"
    }
  },
  "required": ["slug"]
}

Example

Prompt: "Get reviews for text-to-image"

Response:

[
  {
    "score": 90,
    "comment": "Amazing image quality!",
    "createdAt": "2025-01-15T10:30:00Z"
  },
  {
    "score": 85,
    "comment": "Fast and reliable",
    "createdAt": "2025-01-14T15:20:00Z"
  }
]

skillz_groups

List skill groups, optionally filtered by creator.

Input Schema

{
  "type": "object",
  "properties": {
    "creator": {
      "type": "string",
      "description": "Filter by creator wallet address (optional)"
    }
  },
  "required": []
}

Example

Prompt: "List all skill groups on Skillz Market"

Response:

[
  {
    "slug": "ai-tools",
    "name": "AI Tools",
    "description": "Collection of AI utilities",
    "icon": "🤖",
    "isActive": true
  },
  {
    "slug": "image-generation",
    "name": "Image Generation",
    "description": "Text-to-image and image editing skills",
    "icon": "🎨",
    "isActive": true
  }
]

skillz_group

Get details about a specific skill group including its skills.

Input Schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Group slug"
    },
    "creator": {
      "type": "string",
      "description": "Creator wallet address (optional, for scoping)"
    }
  },
  "required": ["slug"]
}

Example

Prompt: "Get details about the ai-tools group"

Response:

{
  "slug": "ai-tools",
  "name": "AI Tools",
  "description": "Collection of AI utilities",
  "icon": "🤖",
  "isActive": true,
  "skills": [
    {
      "slug": "text-to-image",
      "name": "Text to Image",
      "price": "0.01",
      "currency": "USDC"
    },
    {
      "slug": "summarize",
      "name": "Summarize Text",
      "price": "0.005",
      "currency": "USDC"
    }
  ],
  "creator": {
    "walletAddress": "0x...",
    "name": "AI Developer"
  }
}

Next Steps

Configuration - Client-specific setup guides

Tools Reference

On this page