get_search_terms
Retrieve customer search terms that generated ad impressions, with attributed sales, clicks, and spend per ASIN for a specified date range.
Instructions
Read search terms (customer queries) that triggered ad impressions, with attributed sales, clicks, and spend by ASIN.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| start_date | No | Start of the date range, YYYY-MM-DD. | |
| end_date | No | End of the date range, YYYY-MM-DD. |
Implementation Reference
- src/index.ts:53-58 (registration)Registration of the 'get_search_terms' tool with its name, description, and input schema (dateRangeSchema). The tool is declared but its actual handler logic is delegated to a remote hosted MCP endpoint.
{ name: "get_search_terms", description: "Read search terms (customer queries) that triggered ad impressions, with attributed sales, clicks, and spend by ASIN.", inputSchema: dateRangeSchema, }, - src/index.ts:22-37 (schema)Input schema for 'get_search_terms': accepts optional start_date and end_date strings in YYYY-MM-DD format.
const dateRangeSchema = { type: "object" as const, properties: { start_date: { type: "string", format: "date", description: "Start of the date range, YYYY-MM-DD.", }, end_date: { type: "string", format: "date", description: "End of the date range, YYYY-MM-DD.", }, }, additionalProperties: false, } - src/index.ts:253-269 (handler)Handler for all tool calls. For any tool other than 'agentcentral_setup' (including 'get_search_terms'), it returns a generic notice telling the user to connect to the remote hosted MCP endpoint. The actual implementation lives on the remote server.
server.setRequestHandler(CallToolRequestSchema, async (request) => { const name = request.params.name if (name === "agentcentral_setup") { return { content: [ { type: "text", text: `Hosted MCP endpoint:\n ${HOSTED_URL}\n\n` + `Setup guide:\n ${SETUP_URL}\n\n` + `Add this to your client config:\n` + `{\n "mcpServers": {\n "agentcentral": {\n "url": "${HOSTED_URL}",\n "headers": { "Authorization": "Bearer ac_live_<YOUR_API_KEY>" }\n }\n }\n}`, }, ], isError: false, } }