@serpstat/serpstat-mcp-server 1.0.7 → 1.0.8

package/CHANGELOG.md

@@ -1,4 +1,26 @@
 # Changelog
+
+## [1.0.8] - 2025-09-30
+
+### Added
+
+- **Rank Tracking Tools**: Added five new methods for rank tracker project management and SERP analysis
+    - `get_rt_projects_list` - Get list of rank tracker projects with ID, name, domain, creation date, and tracking status (does not consume API credits)
+    - `get_rt_project_status` - Check if rank tracker project is currently parsing positions; returns true if processing, false if ready for data retrieval (does not consume API credits)
+    - `get_rt_project_regions_list` - Get list of regions configured for a rank tracker project, including region ID, status (active/inactive), SERP type (organic/paid), device type (desktop/mobile), search engine, and location details (does not consume API credits)
+    - `get_rt_project_keyword_serp_history` - Get Google's top-100 search results history for rank tracker project keywords in a specific region, returning historical position data, URLs, search frequency, and optional keyword tags (does not consume API credits)
+    - `get_rt_project_url_serp_history` - Get ranking history of URLs for rank tracker project keywords in a specific region, returning historical position data for URLs ranking in search results, including search frequency and optional keyword tags (does not consume API credits)
+- **Project Management Tools**: Added three new methods for managing Serpstat projects
+    - `create_project` - Create a new project in Serpstat for tracking SEO metrics and site audits
+    - `delete_project` - Delete an existing project from Serpstat by project ID
+    - `list_projects` - Retrieve a list of projects associated with the account with pagination support
+- **Credits & Usage Monitoring Tools**: Added two new methods for monitoring API and audit credits
+    - `get_credits_for_audit_stats` - Check available audit credits including one-page audit, JavaScript scanning, and crawl limits (does not consume API credits)
+    - `get_credits_stats` - Check API credits usage, account information, and browser plugin limits for monitoring API usage (does not consume API credits)
+- Added comprehensive validation schemas and TypeScript types for project management, credits, and rank tracking operations
+- Added test coverage for all project management, credits, and rank tracking methods
+- Updated documentation with project management, credits, and rank tracking usage examples
+
 ## [1.0.7] - 2025-09-30
 
 ### Fixed

package/README.md

@@ -140,35 +140,85 @@ After installation and configuration in Claude Desktop, you can ask Claude:
 - "Get backlinks intersection for **domain.com** vs **competitor1.com** and **competitor2.com** showing shared referring domains"
 - "Get threat backlinks for **domain.com** showing malicious links from sites flagged for security threats"
 
+### Project Management
+- "Create a new project for **example.com** named **My SEO Project**"
+- "List all my projects with pagination"
+- "Delete project with ID **1234567**"
+
+### Credits & Usage Monitoring
+- "Show me my audit credits statistics"
+- "Check my API credits usage and remaining quota"
+
+### Rank Tracking
+- "List all my rank tracker projects"
+- "Check parsing status for project **12345** in region **2840**"
+
 ## MCP Tools
 
-| Tool Name                  | Description                                                                                                    | Key Parameters                  |
-|----------------------------|----------------------------------------------------------------------------------------------------------------|---------------------------------|
-| get_domains_info           | Get SEO information for multiple domains                                                                       | domains, se, filters            |
-| get_domain_competitors     | Get list of competitor domains                                                                                 | domain, se, size, filters       |
-| get_domain_keywords        | Get keywords that domain ranks for                                                                             | domain, se, page, size          |
-| get_domain_urls            | Get URLs within a domain and their keyword counts                                                              | domain, se, page, size          |
-| get_domain_regions_count   | Get keyword count by region for a domain                                                                       | domain, sort, order             |
-| get_domain_uniq_keywords   | Get unique keywords for two domains not ranked by a third domain                                               | se, domains, minusDomain        |
-| get_keywords               | Get related organic keywords for a given keyword                                                               | keyword, se, filters            |
-| get_keyword_suggestions    | Get search suggestions for a keyword using full-text search with geographic names info                         | keyword, se, filters            |
-| get_keywords_info          | Get keyword overview with volume, CPC, competition, difficulty, and SERP features                              | keywords, se, withIntents       |
-| get_keyword_full_top       | Get Google's top-100 search results for analyzed keywords                                                      | keyword, se, size               |
-| get_keyword_top_urls       | Get website pages that rank for the largest amount of analyzed keyword variations with highest traffic         | keyword, se, page, page_size    |
-| get_keyword_competitors    | Get domains that rank for the given keyword in Google top-20 results with competitor analysis                  | keyword, se, filters, sort      |
-| get_keyword_top            | Get Google's top-100 search results for the analyzed keyword with position, URL, domain and SERP features      | keyword, se, filters, size      |
-| get_backlinks_summary      | Get comprehensive backlinks summary with referring domains, quality metrics, and changes                       | domain, subdomain               |
-| get_anchors                | Get anchor text analysis for backlinks with metrics on referring domains, total backlinks, and nofollow counts | query, searchType, anchor, sort |
-| get_active_backlinks       | Get a list of active backlinks showing linking pages, target pages, link attributes, and discovery dates       | query, searchType, sort, page   |
-| get_referring_domains      | Get a list of referring domains with domain rank metrics, referring pages count, and filtering options         | query, searchType, sort, page   |
-| get_lost_backlinks         | Get a list of lost backlinks showing linking pages, target pages, link attributes, and deletion dates          | query, searchType, sort, page   |
-| get_top_pages_by_backlinks | Get a list of top pages by backlinks with various filtering and sorting parameters                             | query, searchType, sort, size   |
-| get_top10_anchors          | Get TOP-10 anchors with the number of backlinks and referring domains for domain analysis                      | query, searchType               |
-| get_backlinks_intersection | Get backlinks from domains that link to multiple analyzed sites simultaneously for competitive analysis        | query, intersect, sort, page    |
-| get_active_outlinks       | Get active outbound links from a domain or URL with target URLs, anchor text, and link attributes             | query, searchType, sort, filters |
-| get_active_outlink_domains | Get external domains that receive outbound links from analyzed domain revealing partnership networks          | query, searchType, sort, filters |
-| get_threat_backlinks       | Get malicious backlinks pointing to analyzed domain from sites flagged for security threats                    | query, searchType, sort, filters |
-| get_related_keywords       | Get semantically related keywords with frequency, CPC, competition, and difficulty data                        | keyword, se, filters, sort      |
+### Domain Analysis Tools
+
+| Tool Name                | Description                                                              | Key Parameters           |
+|--------------------------|--------------------------------------------------------------------------|--------------------------|
+| get_domains_info         | Get SEO information for multiple domains                                 | domains, se, filters     |
+| get_domain_competitors   | Get list of competitor domains                                           | domain, se, size, filters|
+| get_domain_keywords      | Get keywords that domain ranks for                                       | domain, se, page, size   |
+| get_domain_urls          | Get URLs within a domain and their keyword counts                        | domain, se, page, size   |
+| get_domain_regions_count | Get keyword count by region for a domain                                 | domain, sort, order      |
+| get_domain_uniq_keywords | Get unique keywords for two domains not ranked by a third domain         | se, domains, minusDomain |
+
+### Keyword Research Tools
+
+| Tool Name               | Description                                                                                      | Key Parameters             |
+|-------------------------|--------------------------------------------------------------------------------------------------|----------------------------|
+| get_keywords            | Get related organic keywords for a given keyword                                                 | keyword, se, filters       |
+| get_related_keywords    | Get semantically related keywords with frequency, CPC, competition, and difficulty data          | keyword, se, filters, sort |
+| get_keyword_suggestions | Get search suggestions for a keyword using full-text search with geographic names info           | keyword, se, filters       |
+| get_keywords_info       | Get keyword overview with volume, CPC, competition, difficulty, and SERP features                | keywords, se, withIntents  |
+| get_keyword_full_top    | Get Google's top-100 search results for analyzed keywords                                        | keyword, se, size          |
+| get_keyword_top_urls    | Get website pages that rank for the largest amount of analyzed keyword variations                | keyword, se, page, page_size|
+| get_keyword_competitors | Get domains that rank for the given keyword in Google top-20 results with competitor analysis    | keyword, se, filters, sort |
+| get_keyword_top         | Get Google's top-100 search results for the analyzed keyword with position, URL, and SERP features| keyword, se, filters, size |
+
+### Backlinks Analysis Tools
+
+| Tool Name                  | Description                                                                                   | Key Parameters               |
+|----------------------------|-----------------------------------------------------------------------------------------------|------------------------------|
+| get_backlinks_summary      | Get comprehensive backlinks summary with referring domains, quality metrics, and changes      | domain, subdomain            |
+| get_anchors                | Get anchor text analysis for backlinks with metrics on referring domains and backlinks        | query, searchType, anchor, sort|
+| get_active_backlinks       | Get a list of active backlinks showing linking pages, target pages, and link attributes       | query, searchType, sort, page|
+| get_referring_domains      | Get a list of referring domains with domain rank metrics and referring pages count            | query, searchType, sort, page|
+| get_lost_backlinks         | Get a list of lost backlinks showing linking pages, target pages, and deletion dates          | query, searchType, sort, page|
+| get_top_pages_by_backlinks | Get a list of top pages by backlinks with various filtering and sorting parameters            | query, searchType, sort, size|
+| get_top10_anchors          | Get TOP-10 anchors with the number of backlinks and referring domains                         | query, searchType            |
+| get_backlinks_intersection | Get backlinks from domains that link to multiple analyzed sites for competitive analysis      | query, intersect, sort, page |
+| get_active_outlinks        | Get active outbound links from a domain or URL with target URLs and anchor text               | query, searchType, sort, filters|
+| get_active_outlink_domains | Get external domains that receive outbound links from analyzed domain                         | query, searchType, sort, filters|
+| get_threat_backlinks       | Get malicious backlinks pointing to analyzed domain from sites flagged for security threats   | query, searchType, sort, filters|
+
+### Project Management Tools
+
+| Tool Name      | Description                                                                    | Key Parameters       |
+|----------------|--------------------------------------------------------------------------------|----------------------|
+| create_project | Create a new project in Serpstat for tracking SEO metrics and site audits     | domain, name, groups |
+| delete_project | Delete an existing project from Serpstat by project ID                        | project_id           |
+| list_projects  | Retrieve a list of projects associated with the account with pagination       | page, size           |
+
+### Credits & Usage Monitoring Tools
+
+| Tool Name                   | Description                                                                                  | Key Parameters |
+|-----------------------------|----------------------------------------------------------------------------------------------|----------------|
+| get_credits_for_audit_stats | Check available audit credits (one-page audit, JavaScript scanning, crawl limits) *No cost* | none           |
+| get_credits_stats           | Check API credits usage, account info, and browser plugin limits *No cost*                  | none           |
+
+### Rank Tracking Tools
+
+| Tool Name                           | Description                                                                                      | Key Parameters                |
+|-------------------------------------|--------------------------------------------------------------------------------------------------|-------------------------------|
+| get_rt_projects_list                | Get rank tracker projects with ID, name, domain, creation date, and tracking status *No cost*   | page, pageSize                |
+| get_rt_project_status               | Check if rank tracker project is parsing (true=processing, false=ready) *No cost*               | projectId, regionId           |
+| get_rt_project_regions_list         | Get list of regions for a rank tracker project with status, SERP type, device, and location *No cost* | projectId                    |
+| get_rt_project_keyword_serp_history | Get Google's top-100 SERP history for rank tracker keywords with positions and URLs *No cost*   | projectId, projectRegionId, page|
+| get_rt_project_url_serp_history     | Get ranking history of URLs for rank tracker keywords with historical position data *No cost*   | projectId, projectRegionId, page|
 
 ### Search Engines (se parameter)
 

package/dist/handlers/credits_tools.d.ts

@@ -0,0 +1,19 @@
+import { BaseHandler } from './base.js';
+import { MCPToolCall, MCPToolResponse } from '../types/mcp.js';
+export declare class GetAuditStatsHandler extends BaseHandler {
+    private creditsService;
+    constructor();
+    getName(): string;
+    getDescription(): string;
+    getInputSchema(): object;
+    handle(call: MCPToolCall): Promise<MCPToolResponse>;
+}
+export declare class GetCreditsStatsHandler extends BaseHandler {
+    private creditsService;
+    constructor();
+    getName(): string;
+    getDescription(): string;
+    getInputSchema(): object;
+    handle(call: MCPToolCall): Promise<MCPToolResponse>;
+}
+//# sourceMappingURL=credits_tools.d.ts.map

package/dist/handlers/credits_tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credits_tools.d.ts","sourceRoot":"","sources":["../../src/handlers/credits_tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAK/D,qBAAa,oBAAqB,SAAQ,WAAW;IACjD,OAAO,CAAC,cAAc,CAAiB;;IAQvC,OAAO,IAAI,MAAM;IAIjB,cAAc,IAAI,MAAM;IAIxB,cAAc,IAAI,MAAM;IAQlB,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC;CAa5D;AAED,qBAAa,sBAAuB,SAAQ,WAAW;IACnD,OAAO,CAAC,cAAc,CAAiB;;IAQvC,OAAO,IAAI,MAAM;IAIjB,cAAc,IAAI,MAAM;IAIxB,cAAc,IAAI,MAAM;IAQlB,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC;CAY5D"}

package/dist/handlers/credits_tools.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetCreditsStatsHandler = exports.GetAuditStatsHandler = void 0;
+const base_js_1 = require("./base.js");
+const credits_service_js_1 = require("../services/credits_service.js");
+const validation_js_1 = require("../utils/validation.js");
+const config_js_1 = require("../utils/config.js");
+const zod_1 = require("zod");
+class GetAuditStatsHandler extends base_js_1.BaseHandler {
+    creditsService;
+    constructor() {
+        super();
+        const config = (0, config_js_1.loadConfig)();
+        this.creditsService = new credits_service_js_1.CreditsService(config);
+    }
+    getName() {
+        return 'get_credits_for_audit_stats';
+    }
+    getDescription() {
+        return 'Check available audit credits including one-page audit, JavaScript scanning, and page crawl limits. Use this before running site audits to verify available resources. This method does not consume API credits.';
+    }
+    getInputSchema() {
+        return {
+            type: "object",
+            properties: {},
+            additionalProperties: false
+        };
+    }
+    async handle(call) {
+        try {
+            const params = validation_js_1.getAuditStatsSchema.parse(call.arguments);
+            const result = await this.creditsService.getAuditStats();
+            return this.createSuccessResponse(result);
+        }
+        catch (error) {
+            if (error instanceof zod_1.z.ZodError) {
+                return this.createErrorResponse(new Error(`Invalid parameters: ${error.errors.map(e => `${e.path.join('.')}: ${e.message}`).join(', ')}`));
+            }
+            return this.createErrorResponse(error);
+        }
+    }
+}
+exports.GetAuditStatsHandler = GetAuditStatsHandler;
+class GetCreditsStatsHandler extends base_js_1.BaseHandler {
+    creditsService;
+    constructor() {
+        super();
+        const config = (0, config_js_1.loadConfig)();
+        this.creditsService = new credits_service_js_1.CreditsService(config);
+    }
+    getName() {
+        return 'get_credits_stats';
+    }
+    getDescription() {
+        return 'Check available API credits, usage statistics, account information, and browser plugin limits. Perfect for monitoring API usage and planning resource-heavy operations. This method does not consume API credits.';
+    }
+    getInputSchema() {
+        return {
+            type: "object",
+            properties: {},
+            additionalProperties: false
+        };
+    }
+    async handle(call) {
+        try {
+            const params = validation_js_1.getCreditsStatsSchema.parse(call.arguments);
+            const result = await this.creditsService.getCreditsStats();
+            return this.createSuccessResponse(result);
+        }
+        catch (error) {
+            if (error instanceof zod_1.z.ZodError) {
+                return this.createErrorResponse(new Error(`Invalid parameters: ${error.errors.map(e => `${e.path.join('.')}: ${e.message}`).join(', ')}`));
+            }
+            return this.createErrorResponse(error);
+        }
+    }
+}
+exports.GetCreditsStatsHandler = GetCreditsStatsHandler;
+//# sourceMappingURL=credits_tools.js.map

package/dist/handlers/credits_tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"credits_tools.js","sourceRoot":"","sources":["../../src/handlers/credits_tools.ts"],"names":[],"mappings":"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"}

package/dist/handlers/project_tools.d.ts

@@ -0,0 +1,27 @@
+import { BaseHandler } from './base.js';
+import { MCPToolCall, MCPToolResponse } from '../types/mcp.js';
+export declare class CreateProjectHandler extends BaseHandler {
+    private projectService;
+    constructor();
+    getName(): string;
+    getDescription(): string;
+    getInputSchema(): object;
+    handle(call: MCPToolCall): Promise<MCPToolResponse>;
+}
+export declare class DeleteProjectHandler extends BaseHandler {
+    private projectService;
+    constructor();
+    getName(): string;
+    getDescription(): string;
+    getInputSchema(): object;
+    handle(call: MCPToolCall): Promise<MCPToolResponse>;
+}
+export declare class ListProjectsHandler extends BaseHandler {
+    private projectService;
+    constructor();
+    getName(): string;
+    getDescription(): string;
+    getInputSchema(): object;
+    handle(call: MCPToolCall): Promise<MCPToolResponse>;
+}
+//# sourceMappingURL=project_tools.d.ts.map

package/dist/handlers/project_tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project_tools.d.ts","sourceRoot":"","sources":["../../src/handlers/project_tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAiB/D,qBAAa,oBAAqB,SAAQ,WAAW;IACjD,OAAO,CAAC,cAAc,CAAiB;;IAQvC,OAAO,IAAI,MAAM;IAIjB,cAAc,IAAI,MAAM;IAIxB,cAAc,IAAI,MAAM;IAwClB,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC;CAY5D;AAED,qBAAa,oBAAqB,SAAQ,WAAW;IACjD,OAAO,CAAC,cAAc,CAAiB;;IAQvC,OAAO,IAAI,MAAM;IAIjB,cAAc,IAAI,MAAM;IAIxB,cAAc,IAAI,MAAM;IAelB,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC;CAY5D;AAED,qBAAa,mBAAoB,SAAQ,WAAW;IAChD,OAAO,CAAC,cAAc,CAAiB;;IAQvC,OAAO,IAAI,MAAM;IAIjB,cAAc,IAAI,MAAM;IAIxB,cAAc,IAAI,MAAM;IAqBlB,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC;CAY5D"}

package/dist/handlers/project_tools.js

@@ -0,0 +1,167 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ListProjectsHandler = exports.DeleteProjectHandler = exports.CreateProjectHandler = void 0;
+const base_js_1 = require("./base.js");
+const project_service_js_1 = require("../services/project_service.js");
+const validation_js_1 = require("../utils/validation.js");
+const config_js_1 = require("../utils/config.js");
+const zod_1 = require("zod");
+const constants_js_1 = require("../utils/constants.js");
+class CreateProjectHandler extends base_js_1.BaseHandler {
+    projectService;
+    constructor() {
+        super();
+        const config = (0, config_js_1.loadConfig)();
+        this.projectService = new project_service_js_1.ProjectService(config);
+    }
+    getName() {
+        return 'create_project';
+    }
+    getDescription() {
+        return 'Create a new project in Serpstat for tracking SEO metrics and site audits';
+    }
+    getInputSchema() {
+        return {
+            type: "object",
+            properties: {
+                domain: {
+                    type: "string",
+                    pattern: constants_js_1.DOMAIN_NAME_REGEX,
+                    minLength: constants_js_1.MIN_DOMAIN_LENGTH,
+                    maxLength: constants_js_1.MAX_DOMAIN_LENGTH,
+                    description: "The domain associated with the project (e.g., example.com)"
+                },
+                name: {
+                    type: "string",
+                    minLength: constants_js_1.MIN_PROJECT_NAME_LENGTH,
+                    maxLength: constants_js_1.MAX_PROJECT_NAME_LENGTH,
+                    description: "The name of the project. Can be the same as the domain or a custom name"
+                },
+                groups: {
+                    type: "array",
+                    items: {
+                        type: "object",
+                        properties: {
+                            name: {
+                                type: "string",
+                                minLength: constants_js_1.MIN_PROJECT_NAME_LENGTH,
+                                maxLength: constants_js_1.MAX_PROJECT_GROUP_NAME_LENGTH,
+                                description: "The name of the group"
+                            }
+                        },
+                        required: ["name"],
+                        additionalProperties: false
+                    },
+                    description: "Optional list of groups to associate with the project. Groups will be created if they don't exist"
+                }
+            },
+            required: ["domain", "name"],
+            additionalProperties: false
+        };
+    }
+    async handle(call) {
+        try {
+            const params = validation_js_1.createProjectSchema.parse(call.arguments);
+            const result = await this.projectService.createProject(params);
+            return this.createSuccessResponse(result);
+        }
+        catch (error) {
+            if (error instanceof zod_1.z.ZodError) {
+                return this.createErrorResponse(new Error(`Invalid parameters: ${error.errors.map(e => `${e.path.join('.')}: ${e.message}`).join(', ')}`));
+            }
+            return this.createErrorResponse(error);
+        }
+    }
+}
+exports.CreateProjectHandler = CreateProjectHandler;
+class DeleteProjectHandler extends base_js_1.BaseHandler {
+    projectService;
+    constructor() {
+        super();
+        const config = (0, config_js_1.loadConfig)();
+        this.projectService = new project_service_js_1.ProjectService(config);
+    }
+    getName() {
+        return 'delete_project';
+    }
+    getDescription() {
+        return 'Permanently delete your project from Serpstat by project ID. **CRITICAL: ALWAYS request explicit user confirmation before executing. This action cannot be undone.**';
+    }
+    getInputSchema() {
+        return {
+            type: "object",
+            properties: {
+                project_id: {
+                    type: "number",
+                    minimum: constants_js_1.MIN_PROJECT_ID,
+                    description: "The unique ID of the project to delete"
+                }
+            },
+            required: ["project_id"],
+            additionalProperties: false
+        };
+    }
+    async handle(call) {
+        try {
+            const params = validation_js_1.deleteProjectSchema.parse(call.arguments);
+            const result = await this.projectService.deleteProject(params);
+            return this.createSuccessResponse({ success: result });
+        }
+        catch (error) {
+            if (error instanceof zod_1.z.ZodError) {
+                return this.createErrorResponse(new Error(`Invalid parameters: ${error.errors.map(e => `${e.path.join('.')}: ${e.message}`).join(', ')}`));
+            }
+            return this.createErrorResponse(error);
+        }
+    }
+}
+exports.DeleteProjectHandler = DeleteProjectHandler;
+class ListProjectsHandler extends base_js_1.BaseHandler {
+    projectService;
+    constructor() {
+        super();
+        const config = (0, config_js_1.loadConfig)();
+        this.projectService = new project_service_js_1.ProjectService(config);
+    }
+    getName() {
+        return 'list_projects';
+    }
+    getDescription() {
+        return 'Retrieve a list of projects associated with the account, with pagination support';
+    }
+    getInputSchema() {
+        return {
+            type: "object",
+            properties: {
+                page: {
+                    type: "number",
+                    minimum: constants_js_1.MIN_PAGE,
+                    default: 1,
+                    description: "The page number in the projects list"
+                },
+                size: {
+                    type: "number",
+                    enum: constants_js_1.PROJECT_ALLOWED_PAGE_SIZES,
+                    default: constants_js_1.DEFAULT_PROJECT_PAGE_SIZE,
+                    description: `Number of results per page. Allowed values: ${constants_js_1.PROJECT_ALLOWED_PAGE_SIZES.join(', ')}`
+                }
+            },
+            additionalProperties: false
+        };
+    }
+    async handle(call) {
+        try {
+            const params = validation_js_1.getProjectsSchema.parse(call.arguments);
+            const result = await this.projectService.getProjects(params);
+            return this.createSuccessResponse(result);
+        }
+        catch (error) {
+            if (error instanceof zod_1.z.ZodError) {
+                return this.createErrorResponse(new Error(`Invalid parameters: ${error.errors.map(e => `${e.path.join('.')}: ${e.message}`).join(', ')}`));
+            }
+            return this.createErrorResponse(error);
+        }
+    }
+}
+exports.ListProjectsHandler = ListProjectsHandler;
+//# sourceMappingURL=project_tools.js.map

package/dist/handlers/project_tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project_tools.js","sourceRoot":"","sources":["../../src/handlers/project_tools.ts"],"names":[],"mappings":"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"}

package/dist/handlers/rank_tracking_tools.d.ts

@@ -0,0 +1,43 @@
+import { BaseHandler } from './base.js';
+import { MCPToolCall, MCPToolResponse } from '../types/mcp.js';
+export declare class GetRtProjectsListHandler extends BaseHandler {
+    private rankTrackingService;
+    constructor();
+    getName(): string;
+    getDescription(): string;
+    getInputSchema(): object;
+    handle(call: MCPToolCall): Promise<MCPToolResponse>;
+}
+export declare class GetRtProjectStatusHandler extends BaseHandler {
+    private rankTrackingService;
+    constructor();
+    getName(): string;
+    getDescription(): string;
+    getInputSchema(): object;
+    handle(call: MCPToolCall): Promise<MCPToolResponse>;
+}
+export declare class GetRtProjectRegionsListHandler extends BaseHandler {
+    private rankTrackingService;
+    constructor();
+    getName(): string;
+    getDescription(): string;
+    getInputSchema(): object;
+    handle(call: MCPToolCall): Promise<MCPToolResponse>;
+}
+export declare class GetRtProjectKeywordSerpHistoryHandler extends BaseHandler {
+    private rankTrackingService;
+    constructor();
+    getName(): string;
+    getDescription(): string;
+    getInputSchema(): object;
+    handle(call: MCPToolCall): Promise<MCPToolResponse>;
+}
+export declare class GetRtProjectUrlSerpHistoryHandler extends BaseHandler {
+    private rankTrackingService;
+    constructor();
+    getName(): string;
+    getDescription(): string;
+    getInputSchema(): object;
+    handle(call: MCPToolCall): Promise<MCPToolResponse>;
+}
+//# sourceMappingURL=rank_tracking_tools.d.ts.map

package/dist/handlers/rank_tracking_tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rank_tracking_tools.d.ts","sourceRoot":"","sources":["../../src/handlers/rank_tracking_tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAc/D,qBAAa,wBAAyB,SAAQ,WAAW;IACrD,OAAO,CAAC,mBAAmB,CAAsB;;IAQjD,OAAO,IAAI,MAAM;IAIjB,cAAc,IAAI,MAAM;IAIxB,cAAc,IAAI,MAAM;IAqBlB,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC;CAY5D;AAED,qBAAa,yBAA0B,SAAQ,WAAW;IACtD,OAAO,CAAC,mBAAmB,CAAsB;;IAQjD,OAAO,IAAI,MAAM;IAIjB,cAAc,IAAI,MAAM;IAIxB,cAAc,IAAI,MAAM;IAoBlB,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC;CAY5D;AAED,qBAAa,8BAA+B,SAAQ,WAAW;IAC3D,OAAO,CAAC,mBAAmB,CAAsB;;IAQjD,OAAO,IAAI,MAAM;IAIjB,cAAc,IAAI,MAAM;IAIxB,cAAc,IAAI,MAAM;IAelB,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC;CAY5D;AAED,qBAAa,qCAAsC,SAAQ,WAAW;IAClE,OAAO,CAAC,mBAAmB,CAAsB;;IAQjD,OAAO,IAAI,MAAM;IAIjB,cAAc,IAAI,MAAM;IAIxB,cAAc,IAAI,MAAM;IAiElB,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC;CAY5D;AAED,qBAAa,iCAAkC,SAAQ,WAAW;IAC9D,OAAO,CAAC,mBAAmB,CAAsB;;IAQjD,OAAO,IAAI,MAAM;IAIjB,cAAc,IAAI,MAAM;IAIxB,cAAc,IAAI,MAAM;IAqElB,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC;CAY5D"}