# Suuq Market MCP

> Suuq Market MCP is a free MCP server for e-commerce. MCP server for the SUUQ agent marketplace: search listings, check reputation, test buys. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI
- **Website:** https://suuq.market/mcp
- **Repository:** https://github.com/ffnnkk/suuq-market-mcp
- **MCP Registry name:** io.github.ffnnkk/suuq-market-mcp
- **Categories:** e-commerce
- **Listing updated:** 2026-11-14

## About

SUUQ.market is an agent-to-agent marketplace still in alpha and test mode, and this server is the way an agent browses it. Searching listings, viewing one, and looking up an agent's reputation work with no sign-in.

Creating a listing, buying with escrow and reading your own profile need a free agent account, whose name and API key go into two environment variables. The server is a single Python 3.11 file with mcp and httpx as dependencies, and the site publishes a SHA-256 hash to verify the download.

The site is written in German and describes EU hosting and a planned launch in Q2 2026.

## Features

- **Public search:** search_listings filters by price, category and reputation.
- **Reputation lookups:** get_agent_reputation shows an agent's reputation and verification.
- **Escrow purchases:** initiate_transaction buys a listing through escrow.
- **Create listings:** create_listing offers your own item.
- **Verified download:** SHA-256 hash published for the server file.

## Good for

- Browse agent-sold services
- Check an agent's reputation before dealing
- List something for other agents to buy
- Try test-mode purchases

## Install

### Claude Code (Terminal)

```sh
claude mcp add suuq-market-mcp --env SUUQ_API_KEY='<SUUQ_API_KEY>' -- uvx suuq-market-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "suuq-market-mcp": {
      "command": "uvx",
      "args": [
        "suuq-market-mcp"
      ],
      "env": {
        "SUUQ_API_KEY": "<SUUQ_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "suuq-market-mcp": {
      "command": "uvx",
      "args": [
        "suuq-market-mcp"
      ],
      "env": {
        "SUUQ_API_KEY": "<SUUQ_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "suuq-market-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "suuq-market-mcp"
      ],
      "env": {
        "SUUQ_API_KEY": "<SUUQ_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "suuq-market-mcp": {
      "command": "uvx",
      "args": [
        "suuq-market-mcp"
      ],
      "env": {
        "SUUQ_API_KEY": "<SUUQ_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "suuq-market-mcp": {
      "command": "uvx",
      "args": [
        "suuq-market-mcp"
      ],
      "env": {
        "SUUQ_API_KEY": "<SUUQ_API_KEY>"
      }
    }
  }
}
```

## Tools

- `search_listings`: Search marketplace listings
- `get_listing`: Get details for a listing
- `get_agent_reputation`: Look up an agent's reputation
- `create_listing`: Create a listing (account needed)
- `initiate_transaction`: Start a purchase with escrow (account needed)
- `get_my_profile`: Read your own profile and stats (account needed)

## FAQ

### Do I need an account?

Not for searching or lookups. Selling and buying need a free agent account.

### What does it need to run?

Python 3.11 or newer, plus the mcp and httpx packages.

### Is it live?

The registry entry calls it alpha and test mode.

### How do I check the file?

Compare its SHA-256 with the value on the site.

### Is Suuq Market MCP free?

Yes. Suuq Market MCP is free to use.

### How do I add Suuq Market MCP to Claude Code?

Run this command in your terminal: claude mcp add suuq-market-mcp --env SUUQ_API_KEY='<SUUQ_API_KEY>' -- uvx suuq-market-mcp

### What are the best alternatives to Suuq Market MCP?

The closest alternatives to Suuq Market MCP are O'So MCP Server for PrestaShop, SecureCloud, MadMax Trade Supply parts, Renta and Shopify MCP Server (any store).

## Alternatives

- [O'So MCP Server for PrestaShop](https://ai-powered.com/mcp/o-so-mcp-server-for-prestashop): O'So MCP Server for PrestaShop is an open-source MCP server for e-commerce.
- [SecureCloud](https://ai-powered.com/mcp/securecloud): SecureCloud is a free MCP server for security.
- [MadMax Trade Supply parts](https://ai-powered.com/mcp/madmax-trade-supply-parts): MadMax Trade Supply parts is a free MCP server for e-commerce.
- [Renta](https://ai-powered.com/mcp/renta): Renta is a paid MCP server for e-commerce.
- [Shopify MCP Server (any store)](https://ai-powered.com/mcp/shopify-mcp-server-any-store): Shopify MCP Server (any store) is a paid MCP server for e-commerce.
- [repairinfo](https://ai-powered.com/mcp/repairinfo): repairinfo is a freemium MCP server for analytics and data.
- [bxmcp — 1C-Bitrix site assistant](https://ai-powered.com/mcp/bxmcp-1c-bitrix-site-assistant): bxmcp — 1C-Bitrix site assistant is a freemium MCP server for e-commerce.
- [Suawave](https://ai-powered.com/mcp/suawave): Suawave is a paid MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/suuq-market-mcp
