SearchMCP

Connect any LLM to the internet with the cheapest, most reliable, and developer-friendly search API.

GitHub

@searchmcp/client

npm (scoped) License: MIT

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

Related Servers