searchmcp-js
SearchMCP
Documentation
@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/clientRequires 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 resultsClient 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:
Development
pnpm install
pnpm generate # re-generate from OpenAPI spec
pnpm buildLicense
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
Model Context Protocol Servers
The Open-Source Multimodal AI Agent Stack: Connecting Cutting-Edge AI Models and Agent Infra
A MCP for Claude Desktop / Claude Code / Windsurf / Cursor to build n8n workflows for you
MCP server to provide Figma layout information to AI coding agents like Cursor
The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.
Instant is the best backend for AI-coded apps. You get auth, permissions, storage, presence, and streams โ everything you need to ship apps your users will love.
Run your own MCP server? See who uses it and what to fix.
Measure it with TrackMCP