# Smart Search MCP

### Overview

**Smart Search MCP** is the Model Context Protocol (MCP) integration layer for **Smart Search v2**.\
It provides a standardized HTTP-based interface that exposes Smart Search capabilities as modular tools.\
Each capability, such as web search or connector search, is wrapped as an independent MCP tool, making them composable and easily integrated into other MCP-compatible systems.

This modular design allows agent frameworks or services to call Smart Search functions directly through standardized MCP endpoints.

***

### Transport and Endpoint

* **Transport Type:** HTTP
* **Server URL:** [`https://search-api.gdplabs.id/mcp/`](https://search-api.gdplabs.id/mcp)

***

### Authentication

Smart Search MCP uses **Bearer Token** authentication.\
The token used here is the same **Smart Search Token** generated through the **Authentication** process described on the 👉 [**Generate Access Token**](https://gdplabs.gitbook.io/smart-search/authentication-and-access-control/authentication/token-generation)

This ensures consistent authorization across the SDK and MCP environments.

***

### Tools

The following tools are available under Smart Search MCP:

| Tool Name                | Description                                                                               |
| ------------------------ | ----------------------------------------------------------------------------------------- |
| `get_web_search_results` | Retrieves search results with multiple result types (`snippets`, `keypoints`, `summary`). |
| `get_web_search_urls`    | Returns only the list of URLs based on a search query.                                    |
| `get_web_search_map`     | Maps a website to retrieve all URLs found on that site.                                   |
| `get_web_page`           | Fetches and processes the content of a given web page.                                    |
| `get_web_page_snippets`  | Extracts relevant snippets from a web page (`paragraph` or `sentence` style).             |
| `get_web_page_keypoints` | Summarizes a web page into key insights or takeaways.                                     |
| `search_github`          | Searches GitHub repositories, pull requests, and issues using GitHub Integration.         |
| `search_google_calendar` | Searches calendar events using Google Calendar integration.                               |
| `search_google_drive`    | Searches files and documents stored in Google Drive.                                      |
| `search_google_mail`     | Searches email messages from connected Gmail accounts.                                    |
