list_quick_tests
List quick tests to review AI visibility analytics. Filter by project for targeted results.
Instructions
List quick tests, optionally filtered by project.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_quick_tests"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| websiteId | No | Filter to a specific project (optional) |
Implementation Reference
- src/tools/quickTest.js:36-36 (handler)Handler function for the 'list_quick_tests' tool — makes a GET request to '/quick-test' with optional websiteId query parameter.
handler: async ({ websiteId }) => api.get('/quick-test', { websiteId }), - src/tools/quickTest.js:30-35 (schema)Input schema for 'list_quick_tests' — accepts an optional websiteId string filter.
inputSchema: { type: 'object', properties: { websiteId: { type: 'string', description: 'Filter to a specific project (optional)' }, }, }, - src/tools/quickTest.js:27-37 (registration)Tool definition object for 'list_quick_tests' — registered with name, description, inputSchema, and handler.
{ name: 'list_quick_tests', description: 'List quick tests, optionally filtered by project.', inputSchema: { type: 'object', properties: { websiteId: { type: 'string', description: 'Filter to a specific project (optional)' }, }, }, handler: async ({ websiteId }) => api.get('/quick-test', { websiteId }), }, - src/client.js:78-83 (helper)The api.get helper used by the handler to make a GET request to the SurfRank API.
export const api = { get: (path, query) => request('GET', path, { query }), post: (path, body) => request('POST', path, { body }), patch: (path, body) => request('PATCH', path, { body }), delete: (path) => request('DELETE', path), }; - src/index.js:31-39 (registration)Registration of quickTestTools (which includes list_quick_tests) into the ALL_TOOLS array for the MCP server.
const ALL_TOOLS = [ ...projectTools, ...keywordTools, ...reportTools, ...quickTestTools, ...keywordResearchTools, ...competitorTools, ...opportunityTools, ];