After scaffolding your server with agenticmarket create, you can add new tools with a single command. For the full end-to-end tutorial, see How to Create an MCP Server.

Using the CLI generator

bashCOPY
agenticmarket add tool get-weather

This command:

1. Creates src/tools/get-weather.ts with a Zod-validated tool skeleton
2. Adds the import to src/tools/index.ts
3. Registers the tool in the tool registry automatically

You do not need to edit index.ts manually.

---

Generated tool structure

Every generated tool follows this pattern:

typescriptCOPY
import { z } from "zod";
import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";

export function registerGetWeatherTool(server: McpServer): void {
  server.tool(
    "get_weather",
    "Describe what this tool does for the AI agent.",
    {
      location: z.string().describe("City name or coordinates"),
    },
    async ({ location }) => {
      // Your logic here
      return {
        content: [
          {
            type: "text" as const,
            text: JSON.stringify({ location, temp: "22°C" }),
          },
        ],
      };
    },
  );
}

Key points:

• Tool names use snake_case (get_weather, not getWeather)
• Descriptions help AI agents decide when to call your tool — be specific
• Zod schemas validate input before your handler runs
• Return isError: true for error responses so the AI knows something failed

---

For API wrapper projects

If you scaffolded with the API wrapper template, your generated tools use the built-in apiClient:

typescriptCOPY
import { apiClient } from "../lib/api-client.js";

const data = await apiClient.get("/users", { q: query });

The apiClient automatically:

• Injects your API key or bearer token from .env
• Enforces request timeouts (configurable via API_TIMEOUT_MS)
• Throws typed ApiClientError with status codes for clean error handling

---

Adding tools manually

You can also create tool files manually. Just follow the pattern above and register them in src/tools/index.ts:

typescriptCOPY
import { registerGetWeatherTool } from "./get-weather.js";

export function registerAllTools(server: McpServer): void {
  registerGetWeatherTool(server);
  // add more tools here
}

---

Naming conventions

---

Next steps

• Test your tools with the MCP Inspector
• Run the pre-publish security audit
• Publish your server on AgenticMarket
• Full tutorial: How to Create an MCP Server