Getting Started
Welcome to MCP Marketplace - your platform for discovering, generating, and publishing Model Context Protocol servers.
1. Create Your Account
Start by creating a free account to access all features:
- Click Register in the top navigation
- Choose email registration or OAuth (GitHub/Google)
- Verify your email if using email registration
- Complete your profile setup
2. Browse Existing Servers
Explore the marketplace to discover community-built MCP servers:
- Use the search bar to find servers by name or functionality
- Filter by categories, tags, or popularity
- View detailed server information, installation instructions, and reviews
- Copy installation commands with one click
3. Try the AI Generator
Generate custom MCP servers instantly using AI:
- Navigate to the Generate page
- Describe your desired server functionality in natural language
- Choose your preferred AI model (Claude, GPT-4, Gemini, or Grok)
- Review and download the generated code
Quick Tip
New users should start by browsing existing servers to understand MCP capabilities, then experiment with the AI generator for custom solutions.
AI Generator Tutorial
Learn how to generate custom MCP servers using our AI-powered generator.
Step 1: Navigate to Generator
Click on Generate in the navigation menu to access the AI generator.
Step 2: Configure API Key
Before generating, ensure you have configured at least one AI provider API key in Settings.
Step 3: Describe Your Server
Write a clear, detailed description of what you want your MCP server to do. Be specific about:
- The main functionality or purpose
- Data sources or APIs to integrate
- Expected inputs and outputs
- Any specific requirements or constraints
Example Prompts
"Create an MCP server that fetches real-time weather data from OpenWeatherMap API and provides current conditions and forecasts for any city."
"Build an MCP server for database queries that can connect to PostgreSQL, execute SELECT queries safely, and return results in JSON format."
"Generate an MCP server that integrates with GitHub API to fetch repository information, issues, and pull requests for a given organization."
Step 4: Select AI Model
Choose your preferred AI model based on your needs:
Claude (Anthropic)
Best for complex logic and detailed code generation
GPT-4 (OpenAI)
Excellent general-purpose generation with broad knowledge
Gemini (Google)
Strong at understanding context and multi-step tasks
Grok (xAI)
Fast generation with creative problem-solving
Step 5: Generate & Review
Click Generate Server and wait for the AI to create your code. The generation typically takes 10-30 seconds.
Review the generated code carefully:
- Check that all required dependencies are included
- Verify the code matches your requirements
- Review any configuration options or environment variables
- Test the code locally before publishing
Step 6: Download or Publish
You can either:
- Download the code to use privately
- Publish to the marketplace to share with the community
- Regenerate if the output doesn't meet your needs
API Keys Setup Guide
Configure API keys for AI providers to use the generator feature. You only need to configure the providers you want to use.
Anthropic (Claude)
1. Create Account
Visit console.anthropic.com and sign up for an account.
2. Generate API Key
- Navigate to Settings → API Keys
- Click "Create Key"
- Copy the key immediately (it won't be shown again)
3. Add to MCP Marketplace
Go to Settings → API Keys and paste your key in the Anthropic field.
Format: sk-ant-...
Models: Claude 3.5 Sonnet, Claude 3 Opus, Claude 3 Haiku
OpenAI (GPT-4)
1. Create Account
Visit platform.openai.com and create an account.
2. Add Payment Method
OpenAI requires a payment method on file. Go to Settings → Billing and add a credit card.
3. Generate API Key
- Navigate to API Keys section
- Click "Create new secret key"
- Name your key and copy it immediately
4. Add to MCP Marketplace
Go to Settings → API Keys and paste your key in the OpenAI field.
Format: sk-proj-...
Models: GPT-4, GPT-4 Turbo, GPT-3.5 Turbo
Google (Gemini)
1. Access Google AI Studio
Visit Google AI Studio and sign in with your Google account.
2. Create API Key
- Click "Get API Key"
- Select or create a Google Cloud project
- Copy the generated API key
3. Add to MCP Marketplace
Go to Settings → API Keys and paste your key in the Google Gemini field.
Format: AIza...
Models: Gemini Pro, Gemini Ultra, Gemini Flash
xAI (Grok)
1. Join xAI Platform
Visit console.x.ai and create an account.
2. Request API Access
Grok API access may require application approval. Follow the onboarding process.
3. Generate API Key
- Navigate to API section
- Create a new API key
- Copy the key securely
4. Add to MCP Marketplace
Go to Settings → API Keys and paste your key in the xAI Grok field.
Format: xai-...
Models: Grok-1, Grok-1.5
Security Best Practices
- Never share your API keys publicly
- Store keys securely and rotate them regularly
- Monitor usage to detect unauthorized access
- Set spending limits on provider platforms
- Use separate keys for development and production
Publishing Servers Guide
Share your MCP servers with the community and help others discover powerful integrations.
Before Publishing
Ensure your server meets these requirements:
- Code is well-tested and functional
- Clear documentation and usage examples
- Proper error handling and validation
- Security best practices implemented
- Dependencies clearly listed
- Open-source license included (MIT, Apache 2.0, etc.)
Publishing Steps
1. Navigate to Submit Page
Click Submit in the navigation (requires login).
2. Fill Server Information
- Name: Clear, descriptive name (e.g., "Weather Data MCP Server")
- Description: Detailed explanation of functionality
- Category: Choose the most relevant category
- Tags: Add relevant keywords for discoverability
3. Provide Repository URL
Link to your GitHub repository (or other git hosting). The repository should include:
- Complete source code
- README with installation and usage instructions
- Example configuration files
- License file
4. Add Installation Instructions
Provide step-by-step installation commands. Example:
# Clone the repository git clone https://github.com/username/mcp-server-name cd mcp-server-name # Install dependencies npm install # Configure environment cp .env.example .env # Edit .env with your settings # Run the server npm start
5. Submit for Review
Click Submit Server. Your submission will be reviewed by moderators for quality and security.
Review Process
Submissions are typically reviewed within 24-48 hours. Reviewers check for:
- Code quality and security
- Documentation completeness
- Proper MCP protocol implementation
- No malicious code or vulnerabilities
- Clear licensing
After Approval
Once approved:
- Your server appears in marketplace listings
- Users can discover, install, and review it
- You can update the server by updating your repository
- You'll receive notifications about reviews and feedback
Publishing Tips
- Include screenshots or demo videos in your README
- Provide real-world use cases and examples
- Respond promptly to user issues and questions
- Keep dependencies up to date
- Version your releases using semantic versioning
Features Overview
Explore the comprehensive features that make MCP Marketplace the go-to platform for MCP servers.
Advanced Search
Find exactly what you need with powerful search filters, category browsing, and tag-based discovery.
AI Code Generation
Generate custom MCP servers instantly using Claude, GPT-4, Gemini, or Grok with natural language descriptions.
Interactive Playground
Test and experiment with MCP servers in a safe, sandboxed environment before installation.
Community Reviews
Read and write reviews, rate servers, and share feedback to help the community make informed decisions.
Security Review
All published servers undergo security review to ensure safe, malware-free code for the community.
Multi-Provider Support
Configure and switch between multiple AI providers seamlessly for optimal generation results.
OAuth Integration
Sign in easily with GitHub or Google OAuth for quick access without creating new passwords.
Usage Analytics
Track server popularity, installation stats, and community engagement with detailed analytics.
Frequently Asked Questions
What is an MCP server?
An MCP (Model Context Protocol) server is a standardized interface that allows AI models to interact with external tools, data sources, and APIs. It provides a structured way for AI systems to access real-time information and perform actions.
Do I need to pay for API keys?
API keys from providers (Anthropic, OpenAI, Google, xAI) are paid services. You'll need to add payment methods on their respective platforms. Costs vary by provider and usage. Most offer free trial credits for new users.
Can I use the marketplace without publishing servers?
Absolutely! You can browse, search, install, and review servers without ever publishing your own. Publishing is optional and only needed if you want to share your servers with the community.
How long does the review process take?
Server submissions are typically reviewed within 24-48 hours. Complex servers may take longer. You'll receive an email notification when your submission is approved or if changes are requested.
Can I update my published server?
Yes! Update your GitHub repository and the changes will be reflected on the marketplace. Major changes may require re-review by moderators for security purposes.
Are my API keys stored securely?
Yes. API keys are encrypted at rest and in transit. They are never logged or displayed in plain text after initial entry. You can delete or update them at any time in Settings.
What programming languages are supported?
MCP servers can be written in any language that supports the MCP protocol. The AI generator primarily produces Python, Node.js/TypeScript, and Go code, but you can publish servers in any language.
How do I report a problematic server?
Each server page has a "Report" button. Use this to flag servers that violate terms of service, contain malicious code, or have other issues. Our moderation team will investigate promptly.
Can I use generated code commercially?
Yes, code generated by the AI is yours to use commercially. However, check the terms of service of your AI provider (Anthropic, OpenAI, etc.) for any specific restrictions they may have.
How do I get support?
For platform issues, contact us at [email protected]. For specific server issues, contact the server author via their GitHub repository. Check the Troubleshooting section below for common solutions.
Troubleshooting
Common issues and their solutions.
API Key Issues
Error: "Invalid API key"
- Verify the key is copied correctly without extra spaces
- Check that the key hasn't been revoked on the provider's platform
- Ensure you're using the correct key format for each provider
- Try regenerating the key on the provider's platform
Error: "Rate limit exceeded"
- Wait a few minutes before trying again
- Check your usage limits on the provider's dashboard
- Consider upgrading your plan if you need higher limits
- Try using a different AI provider temporarily
Generation Issues
Problem: Generated code doesn't work
- Check that all dependencies are installed
- Verify environment variables are set correctly
- Review the generated code for placeholder values that need to be filled in
- Try regenerating with a more detailed prompt
- Test with a different AI model
Problem: Generation takes too long or times out
- Simplify your prompt and request
- Check your internet connection
- Try during off-peak hours
- Use a faster model like GPT-3.5 Turbo or Claude Haiku
Installation Issues
Problem: Dependencies won't install
- Ensure you have the correct package manager (npm, pip, etc.)
- Check your Node.js/Python version matches requirements
- Clear package manager cache (npm cache clean, pip cache purge)
- Try installing dependencies individually to identify the problematic one
Problem: Server won't start
- Check logs for specific error messages
- Verify all environment variables are set
- Ensure required ports are not already in use
- Check file permissions and ownership
Account Issues
Problem: Can't log in
- Verify your email and password are correct
- Try the "Forgot Password" flow
- Clear browser cookies and cache
- Try a different browser or incognito mode
- Check if your account email is verified
Problem: OAuth login not working
- Ensure pop-ups are enabled for this site
- Check that you've authorized the application
- Try revoking and re-granting OAuth permissions
- Clear browser cache and try again
Still Having Issues?
If you can't resolve your issue with the solutions above:
- Check our GitHub issues for known problems
- Join our Discord community for real-time help
- Email [email protected] with details
- Include error messages, browser/OS info, and steps to reproduce
Best Practices
Follow these guidelines to get the most out of MCP Marketplace and create high-quality servers.
Writing Effective Prompts
DO:
- Be specific about functionality and requirements
- Mention the data sources or APIs to integrate
- Specify the programming language if you have a preference
- Include example inputs and expected outputs
- Mention error handling and edge cases
DON'T:
- Use vague descriptions like "make something cool"
- Combine multiple unrelated features in one request
- Forget to mention authentication requirements
- Assume the AI knows your specific use case
Code Quality
Always test generated code thoroughly
Run unit tests, integration tests, and manual testing before publishing
Implement proper error handling
Catch exceptions, validate inputs, and provide meaningful error messages
Use environment variables for sensitive data
Never hardcode API keys, passwords, or credentials
Follow language-specific conventions
Use linters, formatters, and style guides (PEP 8, ESLint, etc.)
Documentation
Your README should include:
- Clear description of what the server does
- Prerequisites (required software, accounts, etc.)
- Installation steps with copy-paste commands
- Configuration guide with example .env file
- Usage examples showing common operations
- API documentation if applicable
- Troubleshooting section for common issues
- Contributing guidelines if open to contributions
- License information
Security
- Validate and sanitize all user inputs to prevent injection attacks
- Use HTTPS for all external API calls
- Keep dependencies up to date to patch vulnerabilities
- Implement rate limiting to prevent abuse
- Never log sensitive information (keys, passwords, tokens)
Performance Optimization
- •Implement caching for frequently accessed data
- •Use connection pooling for database operations
- •Implement pagination for large datasets
- •Use async/await patterns to avoid blocking operations
- •Monitor and log performance metrics
Community Engagement
As a Publisher
- • Respond to issues and PRs promptly
- • Thank users for feedback and contributions
- • Keep a changelog for version updates
- • Be open to feature requests
As a User
- • Leave constructive reviews
- • Report bugs with detailed information
- • Star repositories you find useful
- • Share servers with others
Final Tips
- 1.Start simple and iterate - don't try to build everything at once
- 2.Study existing popular servers to learn best practices
- 3.Use version control (Git) from the start
- 4.Write tests as you develop, not after
- 5.Engage with the community and learn from others