@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