# 1. Clone and setup
git clone <repository-url>
cd mpt-mcp

# 2. Create virtual environment
python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# 3. Install dependencies
pip install -r requirements.txt

# 4. Configure environment
cp config/env.example .env
# Edit .env with your API credentials

# 5. Start the server
./scripts/start/start_server.sh

mpt-mcp/
├── README.md                    # You are here
├── requirements.txt             # Python dependencies
├── .env                         # Your configuration (create from config/env.example)
│
├── src/                         # 🔧 Source code
│   ├── server_stdio.py         # Stdio MCP server (local)
│   ├── api_client.py           # API client with RQL support
│   ├── config.py               # Configuration management
│   ├── cache_manager.py        # Caching system
│   └── openapi_parser.py       # OpenAPI spec parser
│
├── scripts/                     # 🛠️ Utility scripts
│   ├── setup/                  # Setup scripts
│   ├── start/                  # Server startup
│   └── utils/                  # Utilities
│
├── tests/                       # 🧪 Tests
│   ├── test_rql.py             # RQL implementation tests
│   ├── test_mcp_json.py        # MCP protocol tests
│   └── test_stdio_server.py    # Server tests
│
├── docs/                        # 📚 Documentation
│   ├── QUICKSTART.md           # Quick start guide
│   ├── setup/                  # Setup guides
│   ├── guides/                 # User guides (RQL, caching, etc.)
│   └── reference/              # Technical reference
│
└── config/                      # ⚙️  Configuration examples
    ├── cursor_mcp_config.json  # Cursor MCP configuration
    └── env.example             # Environment template

# Get product count
marketplace_query(resource="catalog.products", limit=1)
# Returns: 9,582 products

# Search for Microsoft products
marketplace_query(
    resource="catalog.products",
    rql="ilike(name,*Microsoft*)",
    limit=50
)

# Filter by status
marketplace_query(
    resource="catalog.products",
    rql="eq(status,Published)",
    select="+id,+name,+vendor",
    limit=100
)

# List all available resources
marketplace_resources()

# Get details about a specific resource
marketplace_resource_info(resource="catalog.products")

# Check cache status
marketplace_cache_info()

# Force refresh
marketplace_refresh_cache()

# Run all tests
cd /path/to/mpt-mcp

# Test RQL implementation
./venv/bin/python tests/test_rql.py

# Test MCP protocol
./venv/bin/python tests/test_mcp_json.py

# Test server initialization
pytest tests/test_stdio_server.py

# Get current product count
./venv/bin/python scripts/utils/get_product_count.py

from src.api_client import APIClient
from src.config import config

client = APIClient(
    base_url=config.marketplace_api_base_url,
    token=config.marketplace_api_token
)

# Query with RQL
result = await client.get(
    "/public/v1/catalog/products",
    params={"rql": "ilike(name,*Microsoft*)", "limit": 50}
)

# Copy the example
cp config/env.example .env

# Edit with your credentials
MARKETPLACE_API_BASE_URL=https://api.s1.show
MARKETPLACE_API_TOKEN=your_token_here
OPENAPI_SPEC_URL=https://api.s1.show/public/v1/openapi.json

# Verify setup
./scripts/utils/verify_cursor_setup.sh

# Check environment
source venv/bin/activate
python -c "from src.config import config; config.validate()"

# View logs
./scripts/utils/view_logs.sh

# Or in Cursor: Cmd+Shift+U → Select "MCP: softwareone-marketplace"