SearchMCP

@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

---

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");

---

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