Deployment & Marketplace

Learn how to deploy your MCP servers and monetize them through the Osiris marketplace.

Overview

The Osiris platform provides a complete ecosystem for MCP deployment and monetization:

• Build: Create MCPs with the Osiris SDK
• Deploy: Host your MCPs on external platforms
• Monetize: Earn credits through the marketplace
• Discover: Find and use MCPs built by others

Deployment Workflow

1. Create Your MCP

First, create your MCP project using the Osiris CLI:

npx @osiris-ai/cli create-mcp

This generates a complete project structure with:

• Authentication middleware configured
• Database adapters
• Example tools, prompts, and resources
• Environment configuration
• Build scripts

2. Deploy to External Platform

Since Osiris doesn't provide native hosting yet, deploy your MCP to any platform that supports Node.js:

# Install Vercel CLI
npm i -g vercel

# Deploy your MCP
cd your-mcp-project
vercel --prod

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

# Login and deploy
railway login
railway init
railway up

# Install Heroku CLI and deploy
heroku create your-mcp-name
git push heroku main

# Install Netlify CLI
npm install -g netlify-cli

# Deploy
netlify deploy --prod

3. Connect to Osiris Marketplace

Once deployed, connect your MCP to the Osiris marketplace:

npx @osiris-ai/cli connect-mcp-auth

This command will:

• Prompt for your deployed MCP URL
• Configure authentication connections
• Set up scopes and policies
• Create a marketplace listing
• Generate deployment credentials

Marketplace Features

Discovery & Installation

Users can discover your MCP through:

• Search: Semantic search across MCP descriptions and capabilities
• Categories: Browse by type (Assistant, Productivity, Data, etc.)
• Filtering: Filter by pricing, verification status, and features
• Recommendations: AI-powered suggestions based on user needs

Monetization Models

The Osiris marketplace supports flexible pricing:

Per-Install Pricing

Charge users a one-time fee to install your MCP:

// Set install pricing in your MCP metadata
{
  pricing: {
    install: 5.00  // $5.00 one-time fee
  }
}

Per-Deployment Pricing

Charge for each deployment instance:

{
  pricing: {
    deployment: 10.00  // $10.00 per deployment
  }
}

Per-Call Pricing

Charge per API call or action:

{
  pricing: {
    actions: {
      "send_email": 0.10,      // $0.10 per email sent
      "analyze_data": 0.50,    // $0.50 per analysis
      "default": 0.01          // $0.01 for other actions
    }
  }
}

Freemium Model

Offer basic features for free with premium upgrades:

{
  pricing: {
    install: 0,  // Free to install
    actions: {
      "basic_search": 0,       // Free basic features
      "advanced_search": 0.25  // Paid premium features
    }
  }
}

Credit System

The marketplace uses a credit-based payment system:

• 1 Credit = $1 USD
• Users purchase credits to use MCPs
• Developers earn credits from MCP usage and Knowledge Bases

For Users

• Purchase credits via Stripe or crypto
• Credits are automatically deducted for MCP usage
• Transparent pricing displayed upfront
• Usage analytics and spending reports

For Developers

• Earn credits from MCP sales and usage
• Real-time earnings dashboard
• Automatic payouts to bank accounts or crypto wallets
• Revenue analytics and user insights

Managing Deployments

Update Policies

Modify deployment policies using the CLI:

npx @osiris-ai/cli update-mcp

This allows you to:

• Update the MCP's metadata
• Modify scope restrictions
• Change authentication requirements
• Update pricing models (coming soon)

Monitor Usage

Track your MCP performance:

npx @osiris-ai/cli list-mcp

Access detailed analytics via the Osiris Hub dashboard:

• Usage metrics and trends
• Revenue and earnings
• User feedback and ratings
• Performance monitoring

Version Management

Deploy new versions of your MCP:

1. Update your code and deploy to your hosting platform
2. Update the package version in your osiris.json
3. Run update-mcp again with the new version

The marketplace supports:

• Semantic versioning (1.0.0, 1.1.0, etc.)
• Backward compatibility indicators
• Migration guides for breaking changes
• Rollback capabilities for failed deployments

Best Practices

Security

• Always validate and sanitize user inputs
• Use proper authentication and authorization
• Implement rate limiting for API endpoints
• Keep dependencies updated
• Be secure from prompt injection and PII leakage

User Experience

• Provide clear description of the MCP's capabilities
• Implement proper error handling and messaging

Upcoming Features

Native Hosting (Coming Soon)

• One-click deployment directly from the CLI
• Auto-scaling infrastructure that grows with your MCP
• Built-in monitoring and logging
• Edge deployment for global performance
• Zero-config SSL and custom domains

Getting Help

Documentation

• SDK Reference - Complete SDK documentation
• Authentication Guide - Setting up auth providers
• Policy Engine - Configuring access controls

Community Support

• Discord Community - Get help and share ideas
• GitHub Issues - Report bugs and request features
• Developer Forum - Technical discussions and best practices

Direct Support

• Email: osiris@fetcch.xyz

Ready to deploy your first MCP? Start with our Getting Started guide or dive into the SDK documentation.