@searchmcp/client

Thin TypeScript/JavaScript SDK for the SearchMCP API.
Generated from the OpenAPI spec using typescript-fetch.

Supports REST (/v1/search) endpoint.
Includes full type definitions out of the box.

Pre-Installation

Checkout

• 📚 SearchMCP Docs
• 🔎 SearchMCP API Reference

---

Installation

npm install @searchmcp/client

or

pnpm add @searchmcp/client

or

yarn add @searchmcp/client

Requires Node.js 18+ (native fetch).

---

Usage

import {createClient} from "@searchmcp/client";

const client = createClient(process.env.SEARCHMCP_API_KEY);

// Simple web search const res = await client.search({ query: "latest GPU deals", country: "US", numberOfResults: 5, });

console.log(res.status); // "SUCCESS" console.log(res.results); // array of results

---

Client Factory

import {createClient, SearchMCPClient} from "@searchmcp/client";

const client: SearchMCPClient = createClient("smcp_123", "https://api.searchmcp.io");

• apiKey — required
• basePath — defaults to https://api.searchmcp.io

---

Schemas & Types

All request/response schemas and types are generated from the OpenAPI spec and exported:

import { SearchRequest, SearchResponse, SearchStatus, } from "@searchmcp/client";

See the interactive API Reference for details:

• SearchRequest model
• SearchResponse model

---

Development

pnpm install pnpm generate # re-generate from OpenAPI spec pnpm build

---

License

MIT — see LICENSE