SoftwareOne Marketplace MCP Server
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
SoftwareOne Marketplace MCP Server
A Model Context Protocol (MCP) server that provides AI assistants with access to the SoftwareOne Marketplace API. Features full RQL (Resource Query Language) support, intelligent caching, and streamlined tool interface.
π Quick Start
# 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.shSee docs/QUICKSTART.md for detailed instructions.
β¨ Features
π― Streamlined Tool Interface
Single
marketplace_querytool instead of 200+ individual toolsSupports all 263 GET endpoints from the SoftwareOne API
Simple resource-based access:
catalog.products,commerce.orders, etc.
π Full RQL Support
Complete implementation of Resource Query Language
Filtering:
eq(),ilike(),and(),or(),not(),in(),out()Field selection, sorting, pagination
β‘ Intelligent Caching
24-hour TTL for OpenAPI spec
Fast startup (uses cached spec when available)
Automatic cache refresh
Offline mode support
π Dual Transport Modes
Stdio - Local Cursor integration (single-user) π
SSE - Cloud deployment (multi-tenant capable) βοΈπ₯
Intelligent credential handling: client or server credentials
Case-insensitive header support (X-MPT-Authorization, X-MPT-Endpoint)
π Cloud-Ready (SSE Mode)
Docker support with provided Dockerfile
Docker Compose for easy deployment
Multi-tenant capable - Each client uses their own credentials
Flexible fallback - Server credentials when client doesn't provide
CORS configuration for secure remote access
Cloud platform examples (AWS, GCP, Azure, Heroku)
π Current Stats
9,582 products available in marketplace
263 API endpoints supported
5 tools (vs 200+ with old approach)
24-hour cache TTL
π Project Structure
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π§ Usage
Query Products
# 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
)Available Resources
# List all available resources
marketplace_resources()
# Get details about a specific resource
marketplace_resource_info(resource="catalog.products")Cache Management
# Check cache status
marketplace_cache_info()
# Force refresh
marketplace_refresh_cache()π Documentation
Getting Started
Quick Start Guide - Get up and running in minutes
Setup Guide - Detailed setup instructions
Cursor Integration - Use with Cursor AI
Guides
RQL Guide - Complete RQL usage guide
RQL Reference - Quick operator reference
RQL Implementation - Implementation details
Caching Guide - How caching works
SSE Deployment - Cloud deployment guide βοΈ
Multi-Tenant Guide - Multiple clients with own credentials π₯
Reference
Architecture - System architecture
Features - Complete feature list
Setup Scripts - Script reference guide
π§ͺ Testing
# 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π― Use Cases
For AI Assistants (via Cursor)
Ask natural language questions:
"How many products are in the SoftwareOne marketplace?"
"Find all Microsoft Office products"
"Show me active orders from the last week"
"Get invoices for customer X"
For Developers
Query the API programmatically:
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}
)π Configuration
Create a .env file in the project root:
# 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.jsonSee docs/setup/SETUP.md for details.
π Troubleshooting
Server won't start
# Verify setup
./scripts/utils/verify_cursor_setup.sh
# Check environment
source venv/bin/activate
python -c "from src.config import config; config.validate()"Cursor can't connect
# View logs
./scripts/utils/view_logs.sh
# Or in Cursor: Cmd+Shift+U β Select "MCP: softwareone-marketplace"See docs/setup/TROUBLESHOOTING.md for more help.
π¦ Requirements
Python 3.12+
httpx - Async HTTP client
fastmcp - MCP server framework
pydantic - Data validation
python-dotenv - Environment management
See requirements.txt for complete list.
π€ Contributing
Contributions are welcome! Please:
Fork the repository
Create a feature branch
Make your changes
Add tests
Submit a pull request
π License
[Add your license here]
π Links
π Support
For issues or questions:
Check the Troubleshooting Guide
Review Documentation
Open an issue on GitHub
Made with β€οΈ for SoftwareOne
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
Related MCP Connectors
Lets AI agents analyze API metrics, request logs, and traces, and manage apps and alerts.
Pay-per-use tool marketplace for AI agents. Search, price-check, and call APIs via MCP.
Discover and call 10,000+ production APIs from one MCP server. Pay-per-call billing for AI agents.
Find and call verified APIs from any AI assistant, with free trial calls and previewed writes.