trackmcp
Back to directory
searchmcp

searchmcp-js

View on GitHub

SearchMCP

2 stars TypeScriptOthers Updated Sep 28, 2025

Documentation

@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


Installation

bash
npm install @searchmcp/client
# or
pnpm add @searchmcp/client
# or
yarn add @searchmcp/client

Requires Node.js 18+ (native `fetch`).


Usage

ts
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

ts
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:

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

See the interactive API Reference for details:


Development

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

License

MIT โ€” see LICENSE

Frequently asked questions

What is searchmcp-js?

searchmcp-js is SearchMCP

How do I install searchmcp-js?

Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

Is searchmcp-js open source?

Yes โ€” it is hosted on GitHub at https://github.com/searchmcp/searchmcp-js and has 2 stars.

Related MCP tools

Run your own MCP server? See who uses it and what to fix.

Measure it with TrackMCP