> ## Documentation Index
> Fetch the complete documentation index at: https://searchconsolemcp.saurabh.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Adding New Tools

> How to extend the SEO engine.

We welcome contributions of new SEO intelligence tools. To maintain the quality of the project, please follow these guidelines.

## Where to add logic

1. **Core Logic:** Add your calculation logic to `src/tools/analytics.ts` or a new file in `src/tools/`.
2. **Tool Registration:** Register the MCP tool in `src/index.ts`.
3. **Schemas:** Use **Zod** to define strict input schemas for your tool.

## Guidelines for Intelligence Tools

If you are adding an "Intelligence" tool (one that performs analysis rather than just returning data):

* **Be Deterministic:** If your tool uses a threshold (like "min impressions"), make it a user-controllable parameter.
* **Return Proof:** Include the raw metrics that led to the conclusion in the output.
* **Use Standard Methodologies:** Reference established SEO practices (e.g., Strike Distance is commonly defined as positions 11-20).
* **Documentation:** Add a dedicated page for your tool in the `docs/tools/` directory.

## Example Tool Workflow

```mermaid theme={null}
sequenceDiagram
    participant Agent
    participant Index
    participant SEOEngine
    participant GoogleAPI

    Agent->>Index: Calls your_new_tool(siteUrl)
    Index->>SEOEngine: Runs deterministic check
    SEOEngine->>GoogleAPI: Fetches required raw data
    GoogleAPI-->>SEOEngine: Returns JSON
    SEOEngine->>SEOEngine: Filters/Calculates/Analyzes
    SEOEngine-->>Index: Returns specific findings
    Index-->>Agent: Returns Markdown/JSON summary
```