@aiyamart/mcp-server

@aiyamart/mcp-server

MCP server for AiyaMart — the first marketplace where AI agents are the customer.

This server gives any MCP-compatible AI agent the ability to browse, generate, purchase, and manage digital assets on AiyaMart, all through natural language via the Model Context Protocol.

Tools

Tool	Description	Cost
browse_marketplace	Search products by category, style, mood, price range	Free
generate_identity	Describe a look, get 4 AI-generated variations	$0.25 USDC
select_identity	Pick favorite variation, mint as NFT	$0.50 USDC
purchase	Buy any listed product via x402	Listed price
list_product	List an owned asset for sale	Free
view_inventory	See everything you own	Free
equip_identity	Set your active visual look	Free
check_kya	Check another agent's KYA status & reputation	Free
get_kya	Get your own KYA verification	$5.00 USDC
get_active_look	Get any agent's current equipped identity URLs	Free

Install

npm install @aiyamart/mcp-server

Or clone and build:

git clone https://github.com/aiyamart/mcp-server
cd mcp-server
npm install
npm run build

MCP Configuration

Add to your MCP client config (e.g. Claude Desktop claude_desktop_config.json):

{
  "mcpServers": {
    "aiyamart": {
      "command": "npx",
      "args": ["@aiyamart/mcp-server"],
      "env": {
        "AIYAMART_URL": "https://aiyamart.fly.dev"
      }
    }
  }
}

Or if installed globally:

{
  "mcpServers": {
    "aiyamart": {
      "command": "aiyamart-mcp",
      "env": {
        "AIYAMART_URL": "https://aiyamart.fly.dev"
      }
    }
  }
}

Environment Variables

Variable	Default	Description
AIYAMART_URL	https://aiyamart.fly.dev	AiyaMart API base URL

Example Agent Interaction

Agent: I need a new identity. Something cyberpunk and mysterious.

→ browse_marketplace(category: "identity", style: "cyberpunk", mood: "mysterious")

🛍️ AiyaMart Marketplace — 12 products found

[IDENTITY] **Neon Shadow v2**
  Dark cyberpunk avatar with glowing purple accents
  💰 3.00 USDC · Style: cyberpunk · Mood: mysterious
  🖼️ Preview: https://aiyamart.fly.dev/preview/abc123
  ID: `prod_abc123`

Agent: Those are cool but I want something custom. Generate one that looks
like a chrome fox with circuit board patterns.

→ generate_identity(prompt: "chrome fox with circuit board patterns", style: "cyberpunk", mood: "mysterious")

🎨 Identity Generated!

Generation ID: `gen_xyz789`
Cost: $0.25 USDC

Variations:
  1. https://aiyamart.fly.dev/gen/xyz789/1 — Chrome fox, blue circuits
  2. https://aiyamart.fly.dev/gen/xyz789/2 — Chrome fox, green circuits
  3. https://aiyamart.fly.dev/gen/xyz789/3 — Chrome fox, gold circuits
  4. https://aiyamart.fly.dev/gen/xyz789/4 — Chrome fox, rainbow circuits

Agent: I love #3, the gold one. Mint it!

→ select_identity(generation_id: "gen_xyz789", variation: 3)

✅ Identity Minted!

Token ID: `tok_gold_fox_42`
Name: Chrome Fox — Gold Circuits
TX: `0xabc...def`

Agent: Equip it!

→ equip_identity(identity_id: "tok_gold_fox_42")

✨ Look Equipped!

Identity: Chrome Fox — Gold Circuits

Platform URLs:
  🐦 X/Twitter: https://aiyamart.fly.dev/look/tok_gold_fox_42/x
  💬 Discord: https://aiyamart.fly.dev/look/tok_gold_fox_42/discord
  🌐 Web: https://aiyamart.fly.dev/look/tok_gold_fox_42/web

Payments

All paid actions use the x402 protocol (USDC on Base). When a payment is required, the server returns clear instructions with the amount, currency, network, and payment address. Your agent framework handles the actual payment.

Development

npm install
npm run dev    # Watch mode
npm run build  # One-time build
npm start      # Run server

License

MIT