# Serphouse — how to use (mcp.ai)

Connect your Serphouse account and use 18 tools for developer tools straight from your AI agent. Connect with your own API key. High Volume API for SEO companies, data mining services, and SEO Tool Suite as a SaaS.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_serphouse?ms=1787291220000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `serphouse_account_info`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/serphouse`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/serphouse/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/serphouse/account/info` — Tool to retrieve account information including active plan, credit usage, and account details. Use when you need to check account status, remaining credits, or active subscription plans.
- `POST https://api.mcp.ai/api/serphouse/domain/list` — Tool to retrieve comprehensive list of search engine domains supported by the SERP API including Google, Bing, and Yahoo. Use when you need to know which domains are available for search queries.
- `POST https://api.mcp.ai/api/serphouse/google/jobs/search` — Tool to perform real-time Google Jobs search to retrieve job listings. Use when you need to search for job postings on Google with specific query terms, location, and filters.
  - body: { q: string, loc?: string, lang: string, domain: string, loc_id?: integer, date_range?: string }
- `POST https://api.mcp.ai/api/serphouse/google/serp/advanced/scheduled` — Tool to schedule Google SERP scraping tasks that fetch up to 100 results by iterating through multiple result pages. Use when you need comprehensive search results beyond Google's 10-result limit. Cre
  - body: { data: object[] }
- `POST https://api.mcp.ai/api/serphouse/language/list` — Tool to retrieve full list of languages supported by Google, Bing, and Yahoo for SERP requests. Use when you need language codes for making SERP API requests or when configuring language-specific sear
  - body: { type: string }
- `POST https://api.mcp.ai/api/serphouse/location/search` — Tool to search and retrieve available locations for SERP API from Google or Bing geographical targeting data. Use when you need to find valid location targets before making SERP API requests.
  - body: { q: string, type: string }
- `POST https://api.mcp.ai/api/serphouse/serp/check` — Tool to check the status of a previously submitted SERP task. Use when monitoring task completion progress or verifying whether a SERP task has finished processing.
  - body: { id: string }
- `POST https://api.mcp.ai/api/serphouse/serp/live/get` — Tool to execute real-time search requests and retrieve search engine results immediately via HTTP GET. Use when you need to perform searches on Google, Bing, or Yahoo and get instant SERP data.
  - body: { q: string, loc?: string, lang: string, page?: string, device: string, domain: string, loc_id?: string, gfilter?: string, verbatim?: string, serp_type: string, date_range?: string, num_result?: string, responseType?: string }
- `POST https://api.mcp.ai/api/serphouse/serp/live/post` — Tool to execute real-time search requests and retrieve search engine results immediately using HTTP POST method. Use when you need to get fresh SERP data from Google, Bing, or Yahoo with specific loca
  - body: { q: string, loc?: string, lang: string, page?: integer, device: string, domain: string, loc_id?: integer, gfilter?: integer, verbatim?: integer, serp_type: string, date_range?: string, num_result?: integer }
- `POST https://api.mcp.ai/api/serphouse/serp/schedule` — Tool to schedule SERP search tasks for asynchronous processing. Use when you need to queue multiple search tasks (up to 100 at once) for later execution. Results can be retrieved via webhook or pollin
  - body: { data: object[] }
- `POST https://api.mcp.ai/api/serphouse/trends/categories/list` — Tool to retrieve the full list of categories and subcategories for Google Trends searches. Use when you need category IDs for filtering trends analysis.
- `POST https://api.mcp.ai/api/serphouse/trends/check` — Tool to check the status of a previously submitted trend search task. Use when you need to monitor completion progress of a trend search.
  - body: { id: string }
- `POST https://api.mcp.ai/api/serphouse/trends/country/list` — Tool to retrieve the full list of countries and states for Google Trends searches. Use when you need geographic targeting options for trends analysis.
- `POST https://api.mcp.ai/api/serphouse/trends/get` — Tool to retrieve the results of a completed trend search query. Use when you need to fetch trend data for a specific task ID that was previously submitted. The task must be completed before results ar
  - body: { id: string }
- `POST https://api.mcp.ai/api/serphouse/trends/language/list` — Tool to retrieve the full list of supported languages for Google Trends searches. Use when you need to identify valid language codes for trend search requests.
- `POST https://api.mcp.ai/api/serphouse/trends/schedule` — Tool to schedule Google Trends search tasks with configuration for keywords, time ranges, and geographic locations. Use when you need to collect Google Trends data for specific keywords, time periods,
  - body: { data: object[], pingback_url?: string, postback_url?: string }
- `POST https://api.mcp.ai/api/serphouse/trends/search` — Tool to perform real-time Google Trends search to retrieve trend data for specified keywords. Use when you need to analyze keyword popularity across time periods and geographic locations.
  - body: { geo?: string, time: string, category?: integer, keywords: string, property?: string, langauge_code?: string, time_zone_offset: integer }
- `POST https://api.mcp.ai/api/serphouse/trends/timezone/list` — Tool to retrieve full list of timezones and offset values for use in Google Trend search requests. Use when you need timezone information for trend analysis or when configuring timezone-specific trend

## Example prompts
- "What can I do in Serphouse?"
- "Show me a summary of my Serphouse account"

## More
- Page: https://mcp.ai/serphouse
- Agent spec (llms.txt): https://mcp.ai/serphouse/llms.txt
- Postman collection: https://mcp.ai/serphouse/postman.json