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

Need more help?

Last updated: October 30, 2025