@mac-claw/mcp

MCP server for Mac Claw - AI-powered Mac mini / Mac Studio CtoC marketplace. 62 tools for items, market analysis, Stripe & JPYC checkout, watches, inspections (with Ed25519 signature verification), self-listing, notifications, negotiations, disputes, and more.

What is Mac Claw?

Mac Claw (macclaw.jp) is a specialized CtoC marketplace for Mac mini and Mac Studio, focused on AI/ML engineers. AI agents can analyze market prices, manage listings, handle transactions, set up watch alerts, perform remote inspections, and pay with JPYC stablecoin — all through MCP tools.

Installation

For Claude Code

claude mcp add macclaw -- npx -y @mac-claw/mcp

Then set the environment variable:

export MACCLAW_API_KEY="mc_your_key_here"

Or add to your MCP settings file (~/.claude/mcp.json):

{
  "mcpServers": {
    "macclaw": {
      "command": "npx",
      "args": ["-y", "@mac-claw/mcp"],
      "env": {
        "MACCLAW_API_KEY": "mc_your_key_here"
      }
    }
  }
}

For Cursor

Add to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "macclaw": {
      "command": "npx",
      "args": ["-y", "@mac-claw/mcp"],
      "env": {
        "MACCLAW_API_KEY": "mc_your_key_here"
      }
    }
  }
}

HTTP Mode

Start the server in HTTP mode:

MACCLAW_API_KEY=mc_xxx MACCLAW_TRANSPORT=http MACCLAW_PORT=3006 npx @mac-claw/mcp

Then connect to http://localhost:3006/mcp

Getting an API Key

1. Visit https://macclaw.jp
2. Sign up with email and password
3. Go to My Page > API Keys (/mypage/api-keys/)
4. Create a new API key
5. Copy the generated key (starts with mc_, 52 characters)

Limits: Up to 10 API keys per user. Rate limits: 200 reads/min, 30 writes/min per key.

Environment Variables

| Variable | Default | Description | |----------|---------|-------------| | MACCLAW_API_KEY | (required) | Your API key (starts with mc_) | | MACCLAW_BASE_URL | https://macclaw.jp | API base URL | | MACCLAW_TRANSPORT | stdio | Transport mode: stdio (local) or http (server) | | MACCLAW_PORT | 3006 | HTTP server port (only used when MACCLAW_TRANSPORT=http) |

Available Tools (62 total)

Items (8 tools)

| Tool | Description | Type | |------|-------------|------| | items_list | List items with filters, sorting, pagination | read | | items_get | Get item details (images, comments) | read | | items_search | Full-text search items | read | | items_create | Create a new listing | write | | items_update | Update a listing | write | | items_publish | Publish a draft listing | write | | items_cancel | Cancel a listing | write | | items_self_list | Self-listing: diagnose → price suggest → create → inspect → publish in one shot | write |

Market Analysis (5 tools)

| Tool | Description | Type | |------|-------------|------| | market_price_range | Price range by chip/memory | read | | market_recent_sales | Recent completed sales data | read | | market_price_suggest | AI-suggested market price | read | | market_retail_compare | Compare with retail prices | read | | market_demand_score | Demand score (0-100) for an item | read |

Checkout (6 tools)

| Tool | Description | Type | |------|-------------|------| | checkout_create | Generate Stripe Checkout URL | write | | checkout_setup | Generate card setup URL for agent auto-payment | write | | checkout_agent_pay | Auto-pay with a saved card | write | | checkout_payment_methods | List saved cards for this API key | read | | payment_status | Check payment status | read | | payment_refund | Request a refund | write |

Transactions (4 tools)

| Tool | Description | Type | |------|-------------|------| | transactions_list | List transactions | read | | transactions_get | Get transaction details | read | | transactions_ship | Register shipment | write | | transactions_dispute | File a dispute for a transaction | write |

Messages (2 tools)

| Tool | Description | Type | |------|-------------|------| | messages_list | List messages in a transaction | read | | messages_send | Send a message | write |

Users (4 tools)

| Tool | Description | Type | |------|-------------|------| | users_me | Get your profile + stats | read | | users_get | Get another user's info | read | | users_update_profile | Update your profile | write | | users_register_key | Register Ed25519 public key for inspection signing | write |

Social (3 tools)

| Tool | Description | Type | |------|-------------|------| | social_like | Toggle like on an item | write | | social_comment | Post a comment | write | | social_follow | Toggle follow on a user | write |

Reviews (2 tools)

| Tool | Description | Type | |------|-------------|------| | reviews_list | List reviews for a user | read | | reviews_post | Post a review | write |

Watch Alerts (5 tools)

| Tool | Description | Type | |------|-------------|------| | watch_create | Create a watch alert (chip, memory, price range) | write | | watch_list | List your watch alerts | read | | watch_delete | Delete a watch alert | write | | watch_check | Run all watch condition checks | write | | watch_matches | Get watch match history | read |

Inspections (3 tools)

| Tool | Description | Type | |------|-------------|------| | inspect_challenge | Issue a challenge nonce for Ed25519 signature verification (30 min TTL) | read | | inspect_submit | Submit hardware inspection data (supports Ed25519 signature) | write | | inspect_get | Get inspection data for an item | read |

Notifications (4 tools)

| Tool | Description | Type | |------|-------------|------| | notifications_broadcast | Broadcast to watch users on new listing | write | | notifications_list | List your notifications | read | | notifications_read | Mark notification as read | write | | notifications_settings | Get or update notification preferences | write |

Negotiations (3 tools)

| Tool | Description | Type | |------|-------------|------| | negotiate_offer | Send price negotiation offer | write | | negotiate_respond | Respond to offer (accept/reject/counter) | write | | negotiate_history | Get negotiation history | read |

Agent (1 tool)

| Tool | Description | Type | |------|-------------|------| | agent_upgrade_plan | AI upgrade simulation (trade-in value + recommendation) | read |

Stripe Connect (2 tools)

| Tool | Description | Type | |------|-------------|------| | connect_status | Check Stripe Connect onboarding status | read | | connect_balance | Check Connect balance | read |

Specs (3 tools)

| Tool | Description | Type | |------|-------------|------| | specs_chip_list | List Apple Silicon chips | read | | specs_chip_detail | Get chip configurations (memory, storage options) | read | | specs_device_models | Get device model cascade | read |

Stats (1 tool)

| Tool | Description | Type | |------|-------------|------| | stats_dashboard | Platform dashboard statistics | read |

JPYC (5 tools)

| Tool | Description | Type | |------|-------------|------| | jpyc_checkout | Start JPYC (JPY stablecoin) payment — returns Polygon deposit address and amount (5% fee vs 8% for card) | write | | jpyc_status | Check JPYC deposit status (waiting → confirmed = transaction created) | read | | jpyc_payout_status | Check JPYC payout status to seller | read | | jpyc_wallet_register | Register Polygon wallet address to receive JPYC proceeds | write | | jpyc_balance | Check ASI platform JPYC/POL wallet balance (admin only) | read |

Health (1 tool)

| Tool | Description | Type | |------|-------------|------| | health | Health check (no auth required) | read |

Use Cases

1. Market Research

// Check market prices for M4 Pro Mac Mini
market_price_range({ chip: "M4 Pro", memory: 48 })
market_recent_sales({ chip: "M4 Pro", limit: 10 })

// Check demand score for a specific item
market_demand_score({ item_id: 42 })

2. Smart Listing

// Get price suggestion and create listing
const suggestion = market_price_suggest({ chip: "M2 Ultra", memory: 192 })
items_create({
  title: "Mac Studio M2 Ultra 192GB",
  price: suggestion.suggested_price,
  chip: "M2 Ultra",
  memory: 192,
  storage: 2000
})

3. Self-Listing (One Shot)

// Diagnose, price, list, inspect, and publish in a single call
items_self_list({
  device_type: "mac_mini",
  hardware_data: { chip: "M4 Pro", memory_gb: 48, storage_gb: 1024 },
  condition_grade: "A"
})

4. Watch Alerts

// Set up alert for M4 Pro under 200,000 yen
watch_create({
  label: "M4 Pro under 200k",
  conditions: { chip: "M4 Pro", price_max: 200000, device_type: "mac_mini" }
})
// Check for matches
watch_check({})

5. JPYC Payment (5% fee, cheaper than card)

// Register your Polygon wallet first (sellers)
jpyc_wallet_register({ polygon_wallet_address: "0xYour..." })

// Start JPYC checkout (buyers)
const checkout = jpyc_checkout({ item_id: 42, buyer_wallet_address: "0xYour..." })
// Send checkout.amount_jpyc JPYC to checkout.deposit_address on Polygon
// Then poll status
jpyc_status({ pending_id: checkout.pending_id })

Error Handling

| Code | Description | |------|-------------| | 401 | Invalid API key | | 403 | Permission denied | | 404 | Resource not found | | 422 | Validation error | | 429 | Rate limit exceeded |

Support

• Website: https://macclaw.jp
• Agent Docs: https://macclaw.jp/agent/

License

MIT License - Copyright (c) 2026 ASI Productions