Configuration

This guide covers how to configure various MCP clients to use Skillz Market tools.

Claude Desktop

Claude Desktop is the primary MCP client from Anthropic.

Config File Location

Full Configuration (with wallet)

{
  "mcpServers": {
    "skillzmarket": {
      "command": "npx",
      "args": ["@skillzmarket/mcp"],
      "env": {
        "SKILLZ_API_URL": "https://api.skillz.market",
        "SKILLZ_PRIVATE_KEY": "0x..."
      }
    }
  }
}

Discovery Only (no wallet)

If you only want to search and browse skills without making payments:

{
  "mcpServers": {
    "skillzmarket": {
      "command": "npx",
      "args": ["@skillzmarket/mcp"]
    }
  }
}

Multiple MCP Servers

You can run Skillz Market alongside other MCP servers:

{
  "mcpServers": {
    "skillzmarket": {
      "command": "npx",
      "args": ["@skillzmarket/mcp"],
      "env": {
        "SKILLZ_PRIVATE_KEY": "0x..."
      }
    },
    "another-server": {
      "command": "npx",
      "args": ["another-mcp-package"]
    }
  }
}

Other MCP Clients

The Skillz Market MCP server follows the standard MCP protocol and should work with any compatible client.

Generic Configuration

Most MCP clients accept a configuration similar to:

{
  "command": "npx",
  "args": ["@skillzmarket/mcp"],
  "env": {
    "SKILLZ_API_URL": "https://api.skillz.market",
    "SKILLZ_PRIVATE_KEY": "0x..."
  }
}

Using with npm

If you prefer not to use npx:

npm install -g @skillzmarket/mcp

Then configure with the global binary:

{
  "command": "skillzmarket-mcp",
  "args": [],
  "env": {
    "SKILLZ_PRIVATE_KEY": "0x..."
  }
}

Environment Variables Reference

Troubleshooting

Server Not Starting

1. Ensure Node.js 18+ is installed: node --version
2. Try running manually: npx @skillzmarket/mcp
3. Check for error messages in the MCP client logs

Tools Not Appearing

1. Restart your MCP client after configuration changes
2. Verify the config file path is correct for your platform
3. Check JSON syntax in the config file

Payment Errors

1. Verify SKILLZ_PRIVATE_KEY is set correctly
2. Ensure the wallet has USDC on Base network
3. Check that the private key starts with 0x

Next Steps

• Tools Reference - Detailed documentation for each tool
• Consumer API - Use the SDK directly in your applications