@ipayx/mcp-submit

One-click CLI to publish your Model Context Protocol (MCP) server to every major directory — official registry, Smithery, Glama, PulseMCP, mcp.so, Claude Desktop Extensions, the awesome-mcp lists and more.

Built and maintained by iPayX Protocol — the FX audit API. Use it for our own iPayX MCP server, or for any MCP server you build.

---

✨ What it does

npx @ipayx/mcp-submit submit --all

In one command:

1. Reads your package.json + mcp.json
2. Validates the metadata against the official MCP server schema
3. Submits to 13 directories (API calls, GitHub PRs, browser forms)
4. Logs every outcome to ~/.mcp-submit/history.json

📚 Supported registries

ID	Directory	Type
registry	registry.modelcontextprotocol.io (official)	API
smithery	Smithery	API
glama	Glama	API
mcpso	mcp.so	Browser form
pulsemcp	PulseMCP	Browser form
stork	Stork.ai	Browser form
claude-dxt	Claude Desktop Extensions	GitHub PR
awesome-mcp-official	modelcontextprotocol/servers	GitHub PR
awesome-punkpeye	punkpeye/awesome-mcp-servers	GitHub PR
awesome-appcypher	appcypher/awesome-mcp-servers	GitHub PR
awesome-wong2	wong2/awesome-mcp-servers	GitHub PR
cline	Cline Marketplace	GitHub PR
vscode-gallery	VS Code MCP Gallery	Browser issue

🚀 Install

npm install -g @ipayx/mcp-submit
# or, no install:
npx @ipayx/mcp-submit --help

🔑 Required credentials

Create a .env in your MCP server project (see examples/.env.example):

GITHUB_TOKEN=ghp_xxxxxxxxxxxx     # repo scope — for PR-based registries
SMITHERY_API_KEY=sk_xxxxxxxxxxxx  # for Smithery API publish

For the official MCP registry install the Anthropic CLI:

brew install mcp-publisher          # macOS
# or download from https://github.com/modelcontextprotocol/registry/releases
mcp-publisher login github          # one-time auth

🛠 Commands

mcp-submit init                     # generate mcp.json from package.json
mcp-submit publish                  # npm publish (your MCP server package)
mcp-submit submit --all             # submit everywhere
mcp-submit submit --only registry,smithery,glama
mcp-submit submit --skip claude-dxt --no-browser
mcp-submit submit --dry-run         # preview without making PRs/calls
mcp-submit list                     # show all 13 registries
mcp-submit status                   # show submission history
mcp-submit all                      # publish + submit everywhere

📝 Required mcp.json (or fields in package.json)

{
  "name": "@your-scope/your-mcp-server",
  "displayName": "Your MCP Server",
  "description": "What it does in one sentence.",
  "version": "0.1.0",
  "repository": "https://github.com/you/your-mcp-server",
  "transport": "stdio",
  "license": "MIT",
  "homepage": "https://example.com",
  "categories": ["finance"],
  "keywords": ["fx", "payments"],
  "tools": [
    { "name": "do_thing", "description": "..." }
  ]
}

A full example lives in examples/mcp.json.

🤖 GitHub Action (recommended)

Add the workflow in .github/workflows/publish.yml. On every git tag v*, your server is npm published and propagated to every registry — fully automated.

Required secrets:

• NPM_TOKEN
• MCP_SUBMIT_GH_TOKEN (a PAT with public_repo scope)
• SMITHERY_API_KEY

🌍 For iPayX customers

The iPayX MCP server (FX audit + provider compare + invoice scoring) is published as @ipayx/mcp-fx-audit. Connect it to Claude Desktop, Cursor, Cline, ChatGPT or any MCP client:

{
  "mcpServers": {
    "ipayx-fx-audit": {
      "command": "npx",
      "args": ["-y", "@ipayx/mcp-fx-audit"],
      "env": { "IPAYX_API_KEY": "your_key_here" }
    }
  }
}

Get your API key on ipayx.ai.

---

🇫🇷 Version française

@ipayx/mcp-submit est un CLI une-commande qui publie votre serveur MCP vers 13 annuaires majeurs : registre officiel registry.modelcontextprotocol.io, Smithery, Glama, PulseMCP, mcp.so, Stork, Claude Desktop Extensions, et les listes awesome-mcp-servers (modelcontextprotocol, punkpeye, appcypher, wong2), Cline Marketplace et VS Code Gallery.

Installation rapide

npx @ipayx/mcp-submit submit --all

Pourquoi iPayX a construit ça

iPayX déploie son propre serveur MCP d'audit FX (@ipayx/mcp-fx-audit) sur tous les clients IA possibles. Pour automatiser cette propagation, on a fabriqué cet outil — et on l'open-source pour que toute la communauté MCP en profite.

Pour publier ton propre serveur :

1. npm i -g @ipayx/mcp-submit
2. Ajoute un fichier .env avec GITHUB_TOKEN et SMITHERY_API_KEY
3. Dans ton projet : mcp-submit init puis mcp-submit submit --all

Workflow CI/CD

Le workflow GitHub Actions inclus publie sur npm puis propage automatiquement vers tous les registres à chaque tag v*. Configure les secrets NPM_TOKEN, MCP_SUBMIT_GH_TOKEN et SMITHERY_API_KEY dans ton repo.

---

🤝 Contributing

PRs welcome — especially new registry adapters. Each adapter lives in src/registries/<id>.js and exports { id, name, type, url, requires, submit(meta, opts) }.

📄 License

MIT © 2026 iPayX Protocol