SEO Audit with MCP Agents on ToolYour

For marketers and developers, streamlining workflows is key. Imagine kicking off a comprehensive SEO audit for a web page directly from your IDE or chat interface, without switching contexts. ToolYour brings this power to your fingertips through its Model Context Protocol (MCP) server. This article details a practical workflow for leveraging ToolYour's SEO MCP server to perform on-demand SEO checks, empowering your agents to act as expert digital assistants.

Our goal is to show you how to set up your MCP-compatible agent to interact with ToolYour, provide it with an SEO-related task using the solve_task meta-tool, and understand the output.

Why Agents Need SEO Utilities

In today's fast-paced digital landscape, effective SEO is non-negotiable for online visibility. Manual audits are time-consuming and prone to human error. AI agents, when equipped with the right tools, can automate repetitive checks, analyze data, and provide actionable insights rapidly.

Integrating SEO utilities into your agent's capabilities means:

• Rapid Feedback: Get instant SEO feedback on new content or code changes.
• Contextual Analysis: Agents can analyze content within the development or publishing workflow.
• Scalability: Automate audits across many pages or entire sites programmatically.
• Efficiency: Consolidate your tools; run technical SEO checks without leaving your primary workspace, be it an IDE like Cursor or a chat client like Claude.

ToolYour provides a unified platform with over 200 tools, accessible via browser, REST API, or MCP, enabling your agents to tap into powerful digital utilities, including SEO analysis.

Connect ToolYour MCP

To begin, your MCP-compatible agent client needs to know how to connect to the ToolYour MCP server. This involves configuring your client with the server's endpoint and your API key.

ToolYour's MCP server is accessible at https://api.toolyour.com/mcp. You'll need an API key, which you can generate from your ToolYour dashboard at https://www.toolyour.com/dashboard/api-keys. API keys typically start with ty_.

For a full setup guide specific to various clients like Cursor or Claude, please refer to the dedicated documentation. For instance, detailed instructions on configuring your client for ToolYour can be found on our developers' page: https://www.toolyour.com/developers/mcp.

For most MCP clients, the configuration will resemble this JSON structure:

{
  "mcpServers": {
    "toolyour": {
      "url": "https://api.toolyour.com/mcp",
      "headers": {
        "X-Api-Key": "ty_YOUR_KEY"
      }
    }
  }
}

Replace ty_YOUR_KEY with your actual ToolYour API key. Once configured, your agent client can discover and utilize the tools exposed by the ToolYour SEO MCP server.

Example Goals for solve_task

The primary way for your agent to interact with ToolYour's capabilities via MCP is through the solve_task meta-tool. This powerful tool allows you to express a high-level goal, and the agent, with ToolYour's MCP backing, will determine the best sequence of underlying tools to achieve it.

Here are some example goals you might provide to your agent using solve_task for SEO audits:

Goal 1: Comprehensive SEO Audit

This is the most common use case. You provide a URL and ask for a general SEO assessment.

{
  "tool": "toolyour.solve_task",
  "input": {
    "goal": "Perform a comprehensive SEO audit for the page at `https://yourproduct.com/feature-page` and identify areas for improvement."
  }
}

The agent will then query the ToolYour SEO MCP server to identify relevant tools, such as page speed analysis or keyword density checks, and execute them as part of the audit.

Goal 2: Specific Performance Check

If you're focused on a particular aspect, such as page load times, you can make your goal more specific.

{
  "tool": "toolyour.solve_task",
  "input": {
    "goal": "Analyze the page speed performance of `https://blog.yourcompany.com/latest-post`."
  }
}

This would likely trigger ToolYour's page-speed-analyzer tool via the agent.

Goal 3: Keyword Relevance Analysis

To ensure your content aligns with target keywords, an agent can help.

{
  "tool": "toolyour.solve_task",
  "input": {
    "goal": "Check the keyword relevance and density for 'cloud security' on `https://www.yourtechsolutions.com/security-services`."
  }
}

This goal might utilize ToolYour's keyword-checker to provide insights into how well the page optimizes for the specified terms.

Goal 4: Report Generation

While solve_task typically returns structured data, you can also ask for summaries or reports.

{
  "tool": "toolyour.solve_task",
  "input": {
    "goal": "Generate a concise SEO audit report for `https://your-ecom-store.com/product-category` highlighting critical issues."
  }
}

The agent will process the raw data from ToolYour's tools and synthesize it into a readable format.

When you execute solve_task with these goals, your agent will communicate with the ToolYour SEO MCP server, which orchestrates the execution of the necessary underlying tools.

What Happens Under the Hood

When your agent client sends a solve_task request to the ToolYour SEO MCP server, a sophisticated process unfolds:

1. Goal Interpretation: The ToolYour SEO MCP server receives your natural language goal (e.g., "Perform an SEO audit for...").

2. Tool Discovery: The server's intelligence layer identifies the most appropriate API-backed tools from ToolYour's extensive catalog that can help achieve the specified goal. For an SEO audit, this might involve tools like page-speed-analyzer or keyword-checker, among others available via https://www.toolyour.com/digital-tools. You can explore the available tools at https://www.toolyour.com/digital-tools/seo-audit.

3. Tool Orchestration: The server orchestrates the execution of these tools, potentially in a sequence, passing the necessary parameters (like the target URL).

4. Execution and Quota Consumption: The identified tools are executed. This is the point where your monthly quota is consumed. More details on this in the "Quota Notes" section.

5. Result Aggregation: The outputs from individual tool executions are collected and processed.

6. Response Generation: A comprehensive response, summarizing the audit findings and possibly suggesting improvements, is then returned to your agent client. This response is typically structured, allowing your agent to further process or present the information.

This entire process is designed to be seamless, abstracting away the complexities of individual tool calls and letting your agent focus on fulfilling your high-level request.

API-Backed SEO Tools Only

It's important to note that the ToolYour SEO MCP server specifically exposes API-backed tools. While ToolYour offers a wide array of tools that are free to use directly in your browser without signup (e.g., https://www.toolyour.com/digital-tools), only those with corresponding API endpoints are available through MCP for agent integration.

This ensures reliability, scalability, and predictable performance for programmatic access. Tools like page-speed-analyzer and keyword-checker are examples of digital tools available for agents via MCP. If a tool is listed on the ToolYour website but doesn't have a REST API equivalent, it will not be accessible through the SEO MCP server. This distinction is crucial for developers planning their agent integrations. You can find more information about ToolYour's developer capabilities at https://www.toolyour.com/developers.

Quota Notes

Understanding how ToolYour's quota system works is essential for managing your agent's usage.

• Shared Quota: Your ToolYour API key shares a single monthly quota across all surfaces: REST API calls and MCP agent tool executions. This means actions taken by your SEO MCP server agent contribute to the same pool as any direct REST API integrations.
• Free Plan Details: The free plan includes 500 successful requests per month. Additionally, there's a throughput limit of 5 successful requests per minute.
• Reset Schedule: Your monthly quota resets on the 1st of each calendar month.
• Successful Calls Count: Only successful tool calls consume your quota. Invalid requests or errors generally do not count against your limit.
• Catalog vs. Execution: Browsing the ToolYour catalog or exploring available tools via MCP meta-tools like discover_tools (or even the initial solve_task invocation itself) does not consume your quota. However, when solve_task determines and then executes an underlying SEO tool (e.g., calling the page-speed-analyzer to fulfill your goal), that specific tool execution does count as a successful request.
• Multiple Keys, One Pool: If you have multiple API keys associated with your ToolYour account, they all draw from the same shared monthly quota.
• Exceeding Limits: If you hit your monthly request limit or the per-minute throughput limit on the free plan, further requests will be blocked until your plan is upgraded or until the next calendar month begins. ToolYour does not offer pay-as-you-go overage billing; access simply stops at the cap.

For comprehensive details on plans and usage, visit https://www.toolyour.com/pricing and https://www.toolyour.com/developers/docs/usage-and-plans.

What Success Looks Like

A successful SEO audit with MCP agents on ToolYour means receiving clear, actionable insights directly within your development or operational environment.

When your agent successfully executes an SEO audit via solve_task, you can expect an output similar to the following:

• Structured Data: The output will typically be in a structured format (e.g., JSON), making it easy for your agent to parse and process.
• Key Metrics: Reports will include relevant SEO metrics such as page load time, identified broken links, suggested keyword opportunities, title tag and meta description analysis, and more.
• Recommendations: Beyond raw data, the agent's response, powered by ToolYour's tools, will often include concrete recommendations for improvement. For instance, "Reduce image sizes on page-url by 25% to improve load speed."
• Integration: The output appears where you invoked the agent (e.g., in your IDE's chat panel or a CLI output), allowing for immediate follow-up actions without context switching.

This integration empowers you to rapidly identify and address SEO issues, ensuring your web properties are always optimized for search engines.

FAQ

Q1: What is MCP and how does it relate to ToolYour? A1: MCP stands for Model Context Protocol, a standard for connecting AI agents to external tools. ToolYour provides a remote SEO MCP server that allows AI agents from clients like Cursor or Claude to access ToolYour's API-backed tools, including SEO utilities, using your existing ToolYour API key and quota. More on MCP can be found at https://modelcontextprotocol.io/.

Q2: Are all ToolYour tools available through the SEO MCP server? A2: No. The SEO MCP server only exposes API-backed tools. While ToolYour offers over 200 tools, some are browser-only. Only tools with a corresponding REST API are available for agent integration via MCP.

Q3: Does using solve_task consume my quota? A3: The invocation of solve_task itself, along with browsing the ToolYour catalog or discovering tools, does not consume quota. However, when solve_task orchestrates and executes specific underlying API-backed tools (e.g., a page speed analysis tool) to fulfill your goal, those individual tool executions do count towards your monthly quota.

Q4: How do I get an API key for ToolYour? A4: You can generate an API key by signing up for a ToolYour account and navigating to your dashboard's API Keys section: https://www.toolyour.com/dashboard/api-keys. Your API key will start with ty_.

Q5: What happens if I exceed my free plan quota? A5: If you exceed the 500 successful requests per month or the 5 requests per minute throughput limit on the free plan, further tool execution requests will be blocked. Your quota resets on the 1st of each calendar month, or you can upgrade your plan at https://www.toolyour.com/pricing for increased limits. ToolYour does not have a pay-as-you-go overage billing system.

Q6: Can I use multiple API keys for one ToolYour account? A6: Yes, you can generate multiple API keys for your account. However, all API keys associated with a single ToolYour account share the same monthly quota pool.

Conclusion

Integrating ToolYour's SEO MCP server with your AI agents unlocks a new level of automation and efficiency for SEO audits. By leveraging the solve_task meta-tool, you can empower your agents to perform comprehensive checks, analyze page performance, and ensure your content is search-engine-friendly, all within your preferred development or chat environment.

This workflow provides a powerful bridge between your AI assistant and ToolYour's robust suite of digital tools. For more information on ToolYour's developer offerings and to get started, visit https://www.toolyour.com/developers. Explore the full range of tools available at https://www.toolyour.com/ and unlock the potential of intelligent automation for your SEO strategies.