The CLI for Model Context Protocol servers. Create production-ready MCP servers from scratch, or install existing ones into every IDE — no JSON editing, no manual configuration.
Build a new MCP server:
npm install -g agenticmarket
agenticmarket create my-weather-server
cd my-weather-server && npm install && npm run devInstall an existing MCP server:
agenticmarket auth <your-api-key>
agenticmarket install username/server-namecreate scaffolds a production-ready Hono + TypeScript MCP server with security middleware, rate limiting, and deployment config in ~30 seconds.
install writes MCP entries into VS Code, Cursor, Claude Desktop, and every other IDE you have — automatically.
Browse MCP servers →
Get your API key →
Publish your MCP server and earn →
- What Is AgenticMarket
- Requirements
- Installation
- Quick Start
- Commands
- Supported IDEs
- How It Works
- For MCP Server Creators
- Project Structure
- Contributing
- FAQ
- License
AgenticMarket is where developers build and install MCP servers in one command and creators earn on every call.
The Model Context Protocol (MCP) is the open standard that lets AI assistants — in VS Code, Cursor, Claude Desktop, and other tools — call external tools and data sources. AgenticMarket is the distribution and monetization layer built on top of it.
For developers using MCP servers:
One command installs any server into every IDE you have. No hunting for JSON config paths. No manual authentication setup. Credits are prepaid and consumed per successful call — you only pay when a tool actually runs.
For developers publishing MCP servers:
Submit your HTTP MCP server to AgenticMarket, get a proxy secret, and start earning 80% of every call routed through the platform. No changes required if you're already serving over HTTPS. The Founding Creator program offers 90% revenue share for the first 100 approved creators.
- Node.js 20.6 or higher
- For
installcommands: at least one supported IDE and an AgenticMarket API key - For
create: no account required
Install globally via npm:
npm install -g agenticmarketOr run without installing via npx:
npx agenticmarket <command>The shorthand alias amkt is available after global install:
amkt install username/server-name# Step 1 — Authenticate with your API key
agenticmarket auth am_live_xxxx
# Step 2 — Install an MCP server
agenticmarket install agenticmarket/web-reader
# Step 3 — Open your AI assistant
# The tool is ready. No restart required in most IDEs.The CLI detects every IDE installed on your machine and writes the correct configuration automatically. If you are running the command from inside VS Code or Cursor, those entries appear pre-selected at the top of the prompt.
Scaffold a new MCP server project with security middleware, rate limiting, and deployment config.
agenticmarket create <project-name>
agenticmarket create my-weather-apiOption A: Fresh Server (Start from scratch)
Option B: API Wrapper (Turn an existing REST API into an MCP server)
Interactive prompts ask for:
| Prompt | Options |
|---|---|
| Template | Fresh server (blank) or API wrapper (REST API → MCP bridge) |
| Deploy target | Cloudflare Workers, Docker (Railway/Render), or None |
| Secret auth | Auto-generates MCP_SECRET in .env |
| API config (wrapper only) | Base URL, auth type, auth header |
What you get:
my-weather-api/
├── src/
│ ├── index.ts # Hono server + MCP transport
│ ├── middleware/
│ │ ├── security.ts # HTTPS, secret header, CORS, header stripping
│ │ └── rateLimit.ts # Per-IP sliding window (100 req/min)
│ ├── tools/
│ │ ├── index.ts # Tool registry
│ │ └── echo.ts # Reference tool (Zod validated)
│ └── types.ts
├── .mcp/server.json # Official MCP registry schema
├── .env # Auto-generated secret
├── .env.example
├── package.json # dev, build, inspect, validate, release scripts
├── tsconfig.json
├── wrangler.toml # or Dockerfile, depending on deploy target
└── README.md
Security layers ship enabled by default and are imported as middleware — difficult to accidentally remove:
- Secret header validation (timing-safe constant-time comparison)
- HTTPS enforcement in production (hard reject on HTTP)
- Per-IP rate limiting with
Retry-Afterheaders - CORS (no origins by default)
X-Powered-By/Serverheader stripping- Production requires
MCP_SECRET(500 if missing) - CSP headers + X-Frame-Options DENY
- Body size limit (1 MB — prevents memory DoS)
- Session idle timeout (30 min auto-cleanup)
- Graceful shutdown on SIGTERM/SIGINT
After scaffolding:
cd my-weather-api
npm install
npm run dev # server at http://localhost:3000
npm run inspect # MCP Inspector UI at localhost:6274→ Full create documentation — security details, architecture, roadmap
Save and verify your API key locally.
agenticmarket auth <api-key>Your key is stored in ~/.agenticmarket/config.json. It is never transmitted anywhere except the AgenticMarket platform to authenticate your requests.
Install an MCP server into your IDE configuration files.
agenticmarket install <username>/<server-name>
# The @ prefix is optional — both are equivalent
agenticmarket install @alice/summarizer
agenticmarket install alice/summarizerThe CLI will:
- Verify the server exists on AgenticMarket
- Detect every IDE installed on your machine
- Present a selection prompt — your active IDE's options appear first
- Write the MCP configuration entry for each selected target, creating config directories if they do not exist
Smart pre-selection — if you run the command from inside VS Code, Cursor, Windsurf, or Gemini CLI, that IDE's project and global options are pre-ticked.
Name conflict resolution — if a server with the same name is already installed from a different author, you are prompted to assign an alias so both coexist without overwriting each other.
Remove an MCP server from all IDE configurations it was installed to.
agenticmarket remove <server-name>Show all AgenticMarket MCP servers currently installed across your IDEs.
agenticmarket listCheck your current credit balance.
agenticmarket balanceDisplay your current account details.
agenticmarket whoamiThe CLI automatically detects which IDEs are installed on your machine by checking well-known configuration paths. Only IDEs that are actually present on your system appear in the selection menu.
If an IDE does not appear in the prompt, it is not installed or has not been opened at least once to initialise its config directory.
Each IDE supports one or both of:
- Project — configuration lives inside your project folder (e.g.
.cursor/mcp.json). Can be committed with your project and shared with your team. - Global — configuration lives in your home or app-data directory. Available across all projects.
| IDE | Project Config | Global Config | Detection Signal |
|---|---|---|---|
| VS Code | .vscode/mcp.json |
See paths below | VS Code user-data dir exists |
| Cursor | .cursor/mcp.json |
~/.cursor/mcp.json |
~/.cursor dir exists |
| Claude Desktop | — | See paths below | App config dir exists |
| Claude Code | .mcp.json |
~/.claude.json |
~/.claude dir exists |
| Windsurf | — | ~/.codeium/windsurf/mcp_config.json |
~/.codeium/windsurf dir exists |
| Gemini CLI | .gemini/settings.json |
~/.gemini/settings.json |
~/.gemini dir exists |
| Zed | — | See paths below | Zed config dir exists |
| Cline (VS Code ext) | — | VS Code globalStorage | Extension settings dir exists |
| Codex | — | ~/.codex/config.json |
~/.codex dir exists |
| Antigravity | .gemini/antigravity/mcp_config.json |
~/.gemini/antigravity/mcp_config.json |
~/.gemini/antigravity dir exists |
| IDE | Windows | macOS | Linux |
|---|---|---|---|
| VS Code | %APPDATA%\Code\User\mcp.json |
~/Library/Application Support/Code/User/mcp.json |
~/.config/Code/User/mcp.json |
| Claude Desktop | %APPDATA%\Claude\claude_desktop_config.json |
~/Library/Application Support/Claude/claude_desktop_config.json |
~/.config/claude/claude_desktop_config.json |
| Zed | %APPDATA%\Zed\settings.json |
~/Library/Application Support/Zed/settings.json |
~/.config/zed/settings.json |
Your AI assistant calls a tool
→ AgenticMarket authenticates your API key
→ Your credit balance is verified
→ The request is forwarded to the creator's MCP server
→ The result is returned to your AI assistant
→ Credits are deducted only on a successful response
Charges apply per successful tool call only. If the server is unreachable or returns an error, you are not charged.
The CLI writes MCP server entries using just the plain server name as the key (e.g. web-reader, not agenticmarket/web-reader). This ensures compatibility across all MCP clients — slashes in server names cause parsing issues in several IDEs.
If you have built an MCP server and want it to earn revenue, AgenticMarket handles the distribution, authentication, billing, and payouts.
What you need:
- A publicly accessible HTTPS endpoint serving the MCP protocol
- An AgenticMarket account
How publishing works:
- Submit your server at agenticmarket.dev/dashboard/submit
- The AgenticMarket team reviews it within 24 hours
- On approval, you receive a proxy secret to validate in your server
- Users install your server via the CLI — you earn 80% of every call
- Withdraw earnings via Wise (global) or Razorpay (India) once you reach the $20 minimum
Founding Creator program:
The first 100 approved creators earn 90% revenue share for 12 months, receive featured placement, priority review, and a permanent Founding Creator badge. Learn more →
bin/
cli.js Entry point and command router
src/
config.js IDE registry, detection, config read/write, API key storage
commands/
create.js Scaffold engine — prompts, template copy, token substitution
auth.js Save and verify API key
balance.js Check credit balance
install.js Install an MCP server into IDE config files
list.js List installed MCP servers
remove.js Remove an MCP server from IDE config files
whoami.js Show account info
logout.js Clear stored API key
templates/
fresh/ Blank MCP server template (Hono + MCP SDK)
api-wrapper/ REST API → MCP bridge template
# Install dependencies
npm install
# Run any command locally without global install
node bin/cli.js --help
node bin/cli.js auth <api-key>
node bin/cli.js install username/server-name
node bin/cli.js list
node bin/cli.js remove server-namePull requests are welcome. For significant changes, open an issue first to discuss the proposed change.
- Fork the repository
- Create a feature branch:
git checkout -b feature/my-change - Commit your changes:
git commit -m 'add: my change' - Push and open a pull request
Please note the license terms before contributing. By submitting a pull request you agree that your contribution will be governed by the same license.
MCP is an open standard developed by Anthropic that lets AI assistants call external tools, APIs, and data sources during a conversation. When you ask an AI assistant to read a webpage, check a URL, or query an API, it uses an MCP server to do that. AgenticMarket is the platform where developers find, install, and monetize those servers.
Run npm install -g agenticmarket, authenticate with agenticmarket auth <your-key>, then run agenticmarket install username/server-name. The CLI detects VS Code automatically and writes the correct entry into .vscode/mcp.json or the global VS Code MCP config. No manual JSON editing required.
Same process. After authenticating, run agenticmarket install username/server-name. If you run the command from inside Cursor, the Cursor project and global options appear pre-selected in the IDE prompt. The CLI writes the entry into .cursor/mcp.json or ~/.cursor/mcp.json depending on your selection.
Yes. AgenticMarket automatically detects Claude Desktop and writes to the correct platform-specific config path — claude_desktop_config.json on Windows and macOS, ~/.config/claude/claude_desktop_config.json on Linux.
AgenticMarket uses a prepaid credits system. You purchase credits ($15 minimum, no expiry) and they are consumed per successful MCP tool call. If a call fails or the server is unreachable, you are not charged. You can check your balance at any time with agenticmarket balance.
Yes. The install prompt lets you select multiple targets in one command. You can install to VS Code project config, VS Code global, Cursor global, and Claude Desktop all in a single agenticmarket install run.
VS Code, Cursor, Claude Desktop, Claude Code, Windsurf, Gemini CLI, Zed, Cline (VS Code extension), Codex, and Antigravity. See the Supported IDEs section for the full detection and configuration path details.
Submit your server at agenticmarket.dev/dashboard/submit. Your server needs to be a publicly accessible HTTPS endpoint implementing the MCP protocol. After a 24-hour review, you receive a proxy secret to validate on your server. From that point, every call users make through the platform earns you 80% of the call price. The first 100 approved creators earn 90% for 12 months under the Founding Creator program.
Run agenticmarket create my-server. The CLI scaffolds a production-ready Hono + TypeScript project with security middleware, rate limiting, Zod-validated tools, and deployment config. Choose the Fresh server template for a blank server or API wrapper to bridge an existing REST API. After scaffolding, run npm install && npm run dev to start, then npm run inspect to test with the MCP Inspector.
The source code is publicly visible on GitHub under the MIT license. See LICENSE for the full terms.
Browse all available servers at agenticmarket.dev/servers. AgenticMarket publishes and maintains a set of general-purpose servers under the @agenticmarket namespace — including web-reader, rss-reader, url-status, site-metadata, sitemap-reader, and json-tools — available immediately after you authenticate.
- agenticmarket.dev — Platform homepage
- agenticmarket.dev/servers — Browse MCP servers
- agenticmarket.dev/docs — Full documentation
- agenticmarket.dev/pricing — Credits and pricing
- agenticmarket.dev/docs/founding-creator — Founding Creator program
- support@agenticmarket.dev — Support
MIT — see LICENSE file for details.
Support contact support@agenticmarket.dev.