SoftwareOne Marketplace MCP Server

Multi-tenant MCP server for the SoftwareOne Marketplace API with both stdio (Claude Desktop) and SSE (Cursor, cloud deployment) support.

---

🚀 Quick Start

Claude Desktop (stdio mode)

1. Copy config:

cp examples/claude_desktop_stdio_docker.json ~/Library/Application\ Support/Claude/claude_desktop_config.json

2. Edit config with your credentials:

• MARKETPLACE_API_TOKEN: Your API token
• MARKETPLACE_API_BASE_URL: Your API endpoint

3. Restart Claude Desktop

Cursor (SSE mode)

1. Start server:

docker compose up dev

2. Copy config:

cp examples/cursor_sse.json ~/.cursor/mcp_config.json

3. Configure in Cursor MCP settings:

• X-MPT-Authorization: Your API token
• X-MPT-Endpoint: Your API endpoint

4. Restart Cursor

---

☁️ Cloud Deployment

Railway.app (Easiest)

# Install Railway CLI
npm install -g @railway/cli

# Login
railway login

# Deploy
railway up

# Get your URL
railway status

Your server will be at: https://your-app.up.railway.app

Fly.io (Global Edge)

# Install flyctl
curl -L https://fly.io/install.sh | sh

# Login
fly auth login

# Launch
fly launch

# Deploy
fly deploy

Render.com (Auto-Deploy)

1. Push to GitHub
2. Connect at https://dashboard.render.com
3. Select "Web Service"
4. Connect your repo
5. Render auto-detects render.yaml

---

🔧 Configuration

Environment Variables (stdio mode only)

MARKETPLACE_API_TOKEN=your_token_here
MARKETPLACE_API_BASE_URL=https://api.platform.softwareone.com

HTTP Headers (SSE mode)

X-MPT-Authorization: idt:TKN-XXXX-XXXX:your_token_here
X-MPT-Endpoint: https://api.platform.softwareone.com

---

📚 API Query Examples

List products

marketplace_query(resource="catalog.products", limit=10)

Filter with RQL

marketplace_query(
    resource="catalog.products",
    rql="eq(status,Published)",
    limit=10
)

Get orders

marketplace_query(resource="commerce.orders", limit=5)

---

🏗️ Development

Run tests

docker compose run --rm test

Local development

# SSE mode (hot-reload enabled)
docker compose up dev

# stdio mode
docker compose run --rm stdio

---

📦 Project Structure

mpt-mcp/
├── src/
│   ├── server_sse.py          # SSE server (Cursor, cloud)
│   ├── server_stdio.py        # stdio server (Claude Desktop)
│   ├── api_client.py          # Marketplace API client
│   ├── config.py              # Configuration
│   └── ...
├── examples/                  # Config examples
├── tests/                     # Test suite
├── docker-compose.yml         # Docker services
├── Dockerfile                 # Container image
├── railway.toml               # Railway deployment
├── fly.toml                   # Fly.io deployment
├── render.yaml                # Render deployment
└── requirements.txt           # Python dependencies

---

🔍 Troubleshooting

Railway deployment fails

• Check logs: railway logs
• Verify health check: curl https://your-app.up.railway.app/health

Cursor can't connect

• Ensure server is running: docker ps
• Check logs: docker compose logs dev
• Verify port 8000 is accessible: curl http://localhost:8000/health

Claude Desktop errors

• Check config path: ~/Library/Application Support/Claude/claude_desktop_config.json
• Verify Docker is running: docker ps
• Check Claude logs: tail -f ~/Library/Logs/Claude/mcp*.log

---

🔗 Links

• MCP Documentation
• Railway Docs
• Fly.io Docs
• Render Docs

---

📝 License

MIT