AgenticMarket allows you to install Servers directly into your coding assistant. Once installed, your AI agent can use them automatically when relevant, no copy-pasting, no switching tabs, no manual API calls.

This guide walks you through everything from signing up to making your first server call using AgenticMarket.

For a shorter setup path, use Quickstart. For command-level CLI details, see the CLI Installation doc.

What is a server?

A server (MCP Server) is a tool your AI agent can use. Think of it like giving your AI assistant a new ability, ability to read a webpage, check a domain, fetch live data, or anything else a server provides.

You install servers once. After that your agent discovers and calls them automatically based on what you ask it to do.

---

Step 1 — Create your account

Go to agenticmarket.dev and sign up. You will receive a verification email — confirm it before continuing.

Once verified, sign in and you will land on your dashboard.

---

Step 2 — Add credits to your account

Servers cost a small amount per call — typically between $0.01 and $0.25. You pay only when your agent actually calls a server, not for installing or browsing.

To add credits:

1. Click Buy Credits in the bottom left of your dashboard
2. Or go to agenticmarket.dev/topup
3. Choose an amount — $15, $25, $50, or $100
4. Complete payment

Credits are added instantly and never expire.

You can install and browse Servers without credits. You only need a balance when your agent starts making calls.

Free Trials: Many paid servers offer free trial calls (look for the green 🆓 FREE badge). If a server has a free trial, your first calls will not deduct any credits from your balance until the trial limit is reached.

---

Step 3 — Get your API key

Your API key is how the CLI and your IDE authenticate your account.

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

Your key looks like this:

am_live_xxxxxxxxxxxxxxxxxxxx

If you lose it, go back to the same page and generate a new one.

See Authentication for key handling and security best practices.

---

Step 4 — Install the CLI

Open your terminal and run:

bashCOPY
npm install -g agenticmarket

Verify it installed:

bashCOPY
agenticmarket --version

You can also use the short alias amkt for any command:

bashCOPY
amkt --version

---

Step 5 — Connect your account

bashCOPY
agenticmarket auth am_live_xxxxxxxxxxxxxxxxxxxx

Replace the key with yours. This saves your credentials locally so all future commands work automatically.

---

Step 6 — Find a server to install

Browse available servers at agenticmarket.dev/servers.

To understand category and listing quality requirements from the creator side, see Server Registry.

Each server page shows:

• What the server does
• What tools it provides to your agent
• The price per call
• The install command pre-filled for you

Optional but recommended — Validate in MCP Playground first

Before installing a server, run a quick endpoint check in the MCP Playground. It validates MCP handshake, tool discovery, schema output, and common auth mismatches.

If a server does not respond correctly there, fix that first and then install.

---

Step 7 — Install a server

Copy the install command from the server page, or run:

bashCOPY
agenticmarket install username/server-name

For example:

bashCOPY
agenticmarket install agenticmarket/web-reader

The CLI will ask which IDEs to install to — confirm your choice.

? Install to which IDEs?
  ✔  VS Code
  ✔  Cursor
  ✔  Claude Desktop
  ✔  Claude Code
  ✔  Windsurf
  ✔  Gemini CLI
  ✔  Zed
  ✔  Cline (VS Code ext)
  ✔  Codex
  ✔  Antigravity

That is it. No config files to edit manually.

---

Step 8 — Start using the server

Open VS Code, Cursor, Claude Desktop, Windsurf, Zed, or your supported IDE. Your IDE automatically detects the new server — no restart required for most IDEs like VS Code.

The server's tools appear in your agent's tool picker. You can now ask your agent to use them naturally:

"Read the content of https://example.com and summarise it"
"Check if this domain is reachable"
"Fetch the RSS feed from this blog"

Your agent will discover and call the right tool automatically.

---

Managing your servers

See all installed servers:

bashCOPY
agenticmarket list

Remove a server:

bashCOPY
agenticmarket remove server-name

Check your balance:

bashCOPY
agenticmarket balance

Check your account:

bashCOPY
agenticmarket whoami

---

Your dashboard

Your dashboard shows:

• Overview — current balance, total calls, total spent
• Installed Servers — all servers currently installed on your account
• Spending History — a full log of every call and what it cost
• Credits & Payouts — buy credits or view transaction history
• API Key — manage your authentication key

---

What happens when your balance runs out?

If your balance reaches $0 your agent will receive a clear message that the call could not be completed due to insufficient credits. No silent failures. Buy credits at agenticmarket.dev/topup and calls resume immediately. Your installed servers are never removed.

---

Troubleshooting

Server installed but tools not showing in VS Code

VS Code initialises MCP servers automatically — no restart needed. If tools are not showing, check that GitHub Copilot is active and agent mode is enabled in your VS Code settings.

For deeper diagnostics, run the endpoint through MCP Playground.

agenticmarket: command not found

Run npm install -g agenticmarket again and make sure your npm global bin directory is in your PATH.

Got an error saying invalid API key

Go to dashboard/api-keys and regenerate your key, then run agenticmarket auth <new-key> again.

Not sure which server to start with

Browse agenticmarket.dev/server — servers published by AgenticMarket are a good starting point as they are verified and simple to use.

---

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