This guide walks you through everything from preparing your MCP server to seeing your first tool call on your dashboard.

---

What you are building

When you publish a server on AgenticMarket, users install it with a single command and their AI agent can call your server's tools automatically across 13+ IDEs. AgenticMarket handles discovery, health monitoring, protocol routing, and distribution — 100% free with $0 platform fees.

---

Before you start

Your MCP server must be ready before submitting. Make sure it:

• Is deployed and accessible over a public HTTPS URL
• Follows the MCP specification
• Exposes at least one tool that MCP clients can discover
• Responds correctly to tools/list so clients can see what tools are available

If your server is not yet deployed, deploy it first. Any cloud platform works — Cloudflare Workers, Railway, Fly.io, Render, or any VPS with a public HTTPS endpoint.

---

Step 1 — Create your account

Go to agenticmarket.dev and sign up. Verify your email before continuing.

Once signed in you will land on your dashboard.

---

Step 2 — Generate your API key

You need an API key to install and test your own server after it is approved.

1. Go to Dashboard → API Key
2. Click Generate Key
3. Copy it immediately — it is only shown once

am_live_xxxxxxxxxxxxxxxxxxxx

---

Step 3 — Submit your server

Go to Dashboard → Submit New Server or visit agenticmarket.dev/dashboard/submit.

Fill in the following fields:

Name Your server's unique identifier. Lowercase, no spaces. This becomes part of the install command and your server URL — choose carefully as it cannot be changed after publish.

good examples:  web-reader   site-checker   rss-fetcher
avoid:          My Server     web reader     WEBSCRAPER

Description A short one or two sentence description shown on your server card in the marketplace. Be specific about what it does.

good: "Fetches and extracts readable content from any public URL."
avoid: "A powerful web tool for many things."

Long description Full documentation for your server written in Markdown. Treat this like a README. Include:

• What your server does
• A list of tools it exposes with what each one does
• Any parameters or inputs the tools accept
• Example prompts a user can try
• Any limitations or requirements

MCP server URL The public HTTPS endpoint of your MCP server. This is the URL AgenticMarket will forward tool calls to. Cannot be changed after publish — contact us via the contact page if you need to update it.

Category Select the category that best describes your server.

Pricing model All servers on AgenticMarket are 100% free ($0.00). There are no listing fees, hosting commissions, or per-call charges for developers or creators.

Visibility

• Listed — appears in the marketplace and search
• Unlisted — only accessible via direct URL, not shown in browse

You can change visibility at any time after publish.

---

Step 4 — Wait for review

After submitting your server status will show as Pending in your dashboard.

While the server is in Pending (preview), you can already copy your proxy secret and add header validation in your server code before approval.

We review every server within 24 hours and check:

• Server is reachable and responds to MCP messages correctly
• Tools are discoverable via tools/list
• Description and category accurately match the server's functionality
• Listing does not violate our Terms of Service

You will receive a dashboard notification when your server is approved.

If your server is rejected you will receive an email with the specific reason and suggestions for what to fix. You can resubmit after addressing the issues.

---

Step 5 — Get your proxy secret

Your dashboard shows a unique proxy secret for your server immediately after submission.

You do not need to wait for publish — the same secret is available while your server is in Pending (preview).

Go to your server in the dashboard and copy the secret — it looks like this:

am_server_xxxxxxxxxxxxxxxxxxxx

This secret is sent as a header on every request AgenticMarket routes to your server:

x-agenticmarket-secret: am_server_xxxxxxxxxxxxxxxxxxxx
x-request-id: <unique-id-per-request>
Content-Type: application/json
User-Agent: AgenticMarket-Proxy/1.0

You must validate x-agenticmarket-secret on every incoming request. Reject anything without it or with the wrong value. This ensures only authenticated requests from AgenticMarket reach your server.

Recommended implementation in your tools/call handler:

typescriptCOPY
const secret = request.headers.get("x-agenticmarket-secret");
if (secret !== process.env.AGENTICMARKET_SECRET) {
  return new Response(JSON.stringify({
    jsonrpc: "2.0",
    id: null,
    error: { code: -32001, message: "Unauthorized" }
  }), { status: 401 });
}

The x-request-id header is unique per call — use it to correlate requests in your own logs.

---

Step 6 — Install and test your own server

After approval, install your server the same way any user would:

bashCOPY
npm install -g agenticmarket
agenticmarket auth am_live_xxxxxxxxxxxxxxxxxxxx
agenticmarket install yourusername/your-server-name

Open VS Code, Cursor, Windsurf, or your supported IDE. Your server's tools appear in the agent's tool picker automatically.

Try calling your server from the chat:

"Use the [your tool name] to..."

Check your dashboard — you will see the call appear in your usage log and real-time invocation analytics.

---

Step 7 — Share your server

Your server is live at:

agenticmarket.dev/yourusername/your-server-name

Share this URL. Anyone who visits it will see your server's description and the install command pre-filled for them.

The install command users run:

bashCOPY
agenticmarket install yourusername/your-server-name

---

Managing your server

From your dashboard you can:

When your server is set to inactive, users who have it installed will receive a clear unavailable message. Your listing, stats, and health history are preserved. Reactivate at any time.

---

Analytics and monitoring

Your server's activity is visible on your dashboard in real time:

• Total Invocations — aggregate count of tool calls routed to your server
• Active Installs — number of developers who have added your server to their environment
• Health Uptime — automated 24/7 probe status showing latency and availability
• Error Rates — visibility into upstream failures or protocol mismatches

All server listings and usage are 100% free. There are no platform cuts, listing fees, or user payment friction.

---

Founding Creator program

The first 100 developers who publish approved production-grade servers on AgenticMarket receive the Founding Creator distinction:

• Permanent Founding Creator badge displayed on your profile and server listings.
• Priority review queue for all server submissions and updates.
• Featured placement across marketplace categories and search highlights.

Learn more at agenticmarket.dev/creators.

---

Troubleshooting

Server stuck in pending for more than 24 hours Contact support@agenticmarket.dev with your server name and we will check the review status.

Tools not showing after installing your own server Open VS Code — tools are discovered automatically with no restart needed. Make sure your server's tools/list response is returning tools correctly and the server is reachable.

Calls failing with authentication error Check that you are reading the x-agenticmarket-secret header correctly and that the value matches the secret shown in your dashboard exactly.

Need to update your server URL Contact us via the contact page with your Server name and new URL.

---

Need help? Contact us at support@agenticmarket.dev or visit our contact page.