SkillsApr 9, 2026·2 min read

MCP.so — Open-Source MCP Server Directory

Self-host your own MCP server directory with Next.js and Supabase. Browse, search, and submit community MCP servers. Powers mcp.so. Apache-2.0, 2,000+ stars.

Agent ready

Review-first install path

This asset needs a review step. The copied prompt tells the agent to dry-run, show the writes, then proceed only after confirmation.

Needs Confirmation · 66/100Policy: confirm
Agent surface
Any MCP/CLI agent
Kind
Skill
Install
Single
Trust
Trust: Established
Entrypoint
step-1.md
Review-first command
npx -y tokrepo@latest install a3e80e57-33ca-11f1-9bc6-00163e2b0d79 --target codex

Dry-run first, confirm the writes, then run this command.

TL;DR
MCP.so is a self-hostable, open-source directory for browsing and submitting MCP servers.
§01

What it is

MCP.so is an open-source directory for Model Context Protocol servers. Built with Next.js and Supabase, it lets users browse, search, and submit community MCP servers. The project powers the mcp.so website and can be self-hosted for private MCP server directories. It ships under the Apache-2.0 license.

This tool is for developers looking for MCP servers to use with Claude, and for organizations that want to maintain a private catalog of approved MCP integrations.

§02

How it saves time or tokens

Finding MCP servers scattered across GitHub repositories is time-consuming. MCP.so centralizes discovery with search, categorization, and metadata. Each listing includes installation instructions, configuration snippets, and compatibility information. For organizations, a self-hosted instance serves as a vetted catalog of approved MCP servers.

§03

How to use

  1. Browse mcp.so or self-host your own instance.
  2. Search for MCP servers by function or keyword.
  3. Copy the configuration snippet for your MCP client.
  4. Submit new servers to the directory.
# Self-host MCP.so
git clone https://github.com/chatmcp/mcp.so.git
cd mcp.so

# Set up environment variables
cp .env.example .env.local
# Edit .env.local with your Supabase credentials

# Install and run
npm install
npm run dev

# Access at http://localhost:3000
§04

Example

A typical MCP server listing on the directory:

{
  "name": "filesystem",
  "description": "Read, write, and manage files on the local filesystem",
  "repository": "https://github.com/modelcontextprotocol/servers",
  "category": "filesystem",
  "config": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/dir"]
  },
  "compatible_clients": ["Claude Desktop", "Claude Code"]
}

Copy the config object directly into your MCP client settings.

§05

Related on TokRepo

§06

Common pitfalls

  • Community-submitted servers are not vetted for security. Review server code before granting access to sensitive resources.
  • Self-hosting requires Supabase (or a PostgreSQL database with Supabase client). The setup has a learning curve.
  • MCP server compatibility varies across clients. A server that works with Claude Desktop may need adjustments for other clients.
  • The directory is a catalog, not a package manager. You still need to install MCP servers separately.
  • Listings may become outdated as servers evolve. Check the linked repository for the latest version.
  • Review the official documentation before deploying to production to ensure compatibility with your specific environment and requirements.
  • Start with default settings and customize incrementally. Changing too many configuration options at once makes debugging harder.

Frequently Asked Questions

What is MCP.so used for?+

MCP.so is a directory for discovering MCP servers. Browse by category, search by keyword, and find configuration snippets for adding MCP servers to your AI client setup.

Can I self-host MCP.so?+

Yes. The project is open-source under Apache-2.0. Clone the repository, configure Supabase credentials, and deploy. This is useful for organizations maintaining a private catalog of approved MCP servers.

How do I submit a new MCP server?+

Use the submission form on mcp.so or create a pull request on the GitHub repository. Provide the server name, description, repository URL, installation instructions, and compatible clients.

Does MCP.so include all MCP servers?+

No. It includes community-submitted servers. New servers may not be listed yet. The official Anthropic MCP servers are typically included, along with popular community servers.

Is MCP.so affiliated with Anthropic?+

MCP.so is a community project, not an official Anthropic product. It catalogs servers that implement the Model Context Protocol specification published by Anthropic.

Citations (3)
🙏

Source & Thanks

Created by idoubi. Licensed under Apache-2.0.

chatmcp/mcpso — ⭐ 2,000+

Thanks to idoubi for building the go-to directory for the MCP ecosystem.

Discussion

Sign in to join the discussion.
No comments yet. Be the first to share your thoughts.

Related Assets