# Raven Tools MCP > Raven Tools connects your AI agent to professional SEO data. It lets you track keyword rankings, audit website health, and manage backlink metrics without leaving your chat interface. You get full control over search engine optimization reporting straight from natural conversation. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** raven-tools, seo-api, keyword-rank-tracking, seo-audit-automation, backlink-monitoring, marketing-reporting-tools, serp-analysis, website-health-tools, mcp ## Description Raven Tools connects your AI agent straight into professional SEO data, letting you manage everything from keyword rankings to site audits without leaving your chat interface. You get full control over search engine optimization reporting just by talking to your agent. When you're getting set up for a client, you start with project visibility. Your agent can use the `list_projects` tool to show you every active client account and their associated domains in your system. Once you know which projects are running, you can pull core details and status reports using the `get_project` tool, giving you an immediate overview of what's going on with that specific client’s domain. To manage what needs tracking, you first handle the keywords and competitors. You use `list_keywords` to get a complete list of every single keyword already managed within a project scope. If you need to track a new term, run the `add_keyword` tool; this adds the necessary keyword for ranking monitoring. When a keyword's tracking is done, simply call `remove_keyword` to delete it from active monitoring. For competitive analysis, you handle domains and keywords in batches. You can use `list_competitors` to see all the competitor domains currently tracked against your client. Need to add a new rival? The `add_competitor` tool lets you manually input a new domain into your managed list for comparison. If you ever need to see which competitors you're tracking, `list_competitors` gives you that roster. When it comes time to check performance, the ranking tools do the heavy lifting. You can get the current search engine rank for one specific keyword in a project using `get_rank`. But if you wanna see the full picture—the rankings for every single tracked term across an entire client portfolio—you use `get_rank_all`. This provides bulk data on all your key metrics. To keep things running, you should check the system connection status by calling `check_raventools_status`, which verifies both your account's active connection and API connectivity. For site health and authority, you have two main mechanisms. You can run a full technical audit report on any domain using `get_site_audit`. This pulls the latest site health score and points out technical issues that need fixing. To gauge external authority, your agent runs the `get_links` tool, which retrieves a comprehensive list of backlinks associated with a specific domain. These tools let you manage entire SEO workflows: You can get project status via `get_project`, monitor rankings using both `get_rank` and `get_rank_all`, maintain site health by running `get_site_audit`, assess authority through backlink retrieval with `get_links`, and keep track of who's competing by adding or listing domains using `add_competitor` and `list_competitors`. You'll never have to export a CSV again; your AI client handles all the data pulling directly in conversation. ## Tools ### add_competitor Adds a new competitor domain to your managed list. ### add_keyword Adds a keyword that needs to be tracked for ranking purposes. ### check_raventools_status Verifies the active connection and API connectivity status of your Raven Tools account. ### get_links Retrieves a list of backlinks associated with a specified domain. ### get_project Gets core information and status details for a specific client project or domain. ### get_rank_all Retrieves the ranking data for all tracked keywords in an entire portfolio or project. ### get_rank Fetches the current search engine ranking position for one keyword within a project. ### get_site_audit Pulls the latest technical audit report and site health score for a domain. ### list_competitors Lists all currently tracked competitor domains in your account. ### list_keywords Retrieves the complete list of keywords managed within a specific project scope. ### list_projects Lists all active client projects and their associated domains in your account. ### remove_keyword Deletes a keyword from tracking, stopping its monitoring. ## Prompt Examples **Prompt:** ``` List all active projects in my Raven Tools account and show the keyword summary for 'Project A'. ``` **Response:** ``` I've retrieved your projects. You currently have 10 active high-fidelity portfolios. For 'Project A' (ID: proj_123), I've identified 50 tracked keywords with an average SERP position of 5. Would you like the detailed technical metadata for any of them? ``` **Prompt:** ``` Show the latest SEO audit results for 'example.com'. ``` **Response:** ``` Audit intelligence orchestrated! For example.com, I've identified a high-fidelity health score of 85%. There are 10 technical issues flagged, including 5 broken links. I've retrieved the technical step metadata for your review. Need help prioritizing the fixes? ``` **Prompt:** ``` Check for any keywords with significant rank drops this week. ``` **Response:** ``` Operational monitoring orchestrated! I've identified 3 high-fidelity keywords with rank drops greater than 5 positions, including 'AI Tools'. I've retrieved the technical SERP metadata for your review. Shall I check for any corresponding site health changes? ``` ## Capabilities ### Check keyword rankings Retrieves the current search engine ranking position for specific keywords and projects. ### List all tracked keywords Provides a complete, programmatic list of all managed keywords within your account. ### Run technical site audits Queries the latest website audit results to identify health scores and technical issues. ### Monitor backlinks Accesses a directory of backlinks and domain metrics to assess external authority. ### Identify competitors Adds, lists, or manages competitor domains for comparative analysis. ### Review project details Retrieves core information about specific client projects and monitored domains. ## Use Cases ### Checking for recent rank drops A specialist notices a client's rankings dipped. They ask their agent, "Show me any keywords with significant rank drops this week." The agent runs operational monitoring and uses `get_rank_all` to find the three affected terms instantly. ### Onboarding a new client project An agency manager starts tracking a brand-new domain. They first use `list_projects` to confirm it's set up, then run `add_competitor` and `list_keywords` to build out the initial keyword portfolio. ### Deep dive into site health A developer needs a quick technical assessment for a staging environment. They prompt the agent to run `get_site_audit`, receiving a detailed report on broken links and performance metrics without opening any separate web tools. ### Building out a keyword portfolio A team needs to expand coverage for an existing client. They use `list_keywords` to see the current list, then run `add_keyword` repeatedly with new terms and immediately track them using `get_rank`. ## Benefits - See instant rank updates. Use `get_rank` to pull the exact SERP position for any keyword in seconds, eliminating manual checks of spreadsheet data. - Audit entire sites at once. The `get_site_audit` tool pulls technical performance metrics and health scores immediately, letting you see exactly what needs fixing. - Manage keywords programmatically. Instead of manually adding rows, use `add_keyword` or `list_keywords` to keep your keyword database perfectly updated via conversation. - Track authority over time. The `get_links` tool gives you a clear view of backlinks and domain metrics, helping you monitor external visibility trends. - Scope out the competition easily. Use `add_competitor` or `list_competitors` to build a full competitive profile for any client project in one flow. ## How It Works The bottom line is you talk to your agent, and the agent runs the necessary SEO tool calls for you. 1. 1. Subscribe to the Raven Tools server. 2. 2. Grab your API Key from your Raven Tools dashboard (Settings > API). 3. 3. Use your AI client to issue natural language commands, letting it run tools like `get_rank` or `list_keywords`. ## Frequently Asked Questions **How do I check rankings for multiple keywords in Raven Tools?** Use the `get_rank_all` tool. This allows you to fetch ranking data for an entire group of keywords or a whole portfolio at once, rather than running individual calls. **Can I use add_competitor and list_competitors together?** Yes. You can first run `list_competitors` to see what's tracked. Then, if you find a new rival, simply use `add_competitor` to bring them into the system for tracking. **What is the difference between getting site audit and get_project?** The `get_site_audit` tool provides technical performance metrics (like health score or broken links). The `get_project` tool gives high-level, overall metadata about the entire client relationship. **Does Raven Tools help me remove old keywords?** Yes. If a keyword is no longer relevant for tracking, use the `remove_keyword` tool to clean up your portfolio and stop wasting API calls on outdated data. **How do I verify my API connection before running complex reports using `check_raventools_status`?** It immediately confirms your account's connectivity. Running this tool first verifies that the MCP client can talk to the Raven Tools service, preventing failed queries and saving you time later. **If I have many domains, how do I see all my active projects using `list_projects`?** It returns a complete list of every project ID in your account. You then pass these IDs to tools like `get_site_audit` or `get_rank` to ensure you cover all portfolios without manual data entry. **Are there rate limits if I run many queries, such as multiple calls to `get_links`?** Yes, the API enforces standard usage rates. If your agent hits a limit, it receives a specific error code that tells you exactly how long to wait before retrying the query. **Can I use `get_rank` to analyze ranking changes over time?** You must provide a date range when calling this tool. This lets your AI client compare current rankings against historical data points, helping you identify true performance trends. **How do I find my Raven Tools API Key?** Log in to your account, navigate to **Settings** > **API**, and copy your unique Access Token from the credentials section. **Can I check keyword rankings via AI?** Yes! The `list_raven_keywords` tool allows your agent to retrieve high-fidelity position metadata for all tracked search terms. **How do I list my active projects?** Use the `list_raven_projects` tool to retrieve your complete high-fidelity directory along with the unique identifiers for all managed SEO campaigns.