How to integrate Ahrefs MCP with Kimi Code

Trusted by
AWS
Glean
Zoom
Airtable
GET STARTED FOR FREEGET A DEMO

30 min · no commitment · see it on your stack

Ahrefs logo
Kimi Code logo
divider

How to integrate Ahrefs MCP with Kimi Code

Kimi Code is Moonshot AI's open-source coding agent, powered by Kimi K2.6. It runs in your terminal, reads and edits code, executes shell commands, and plans multi-step tasks, with native MCP support for extending it to outside tools.

In this guide, I will explain the easiest and most secure way to connect your Ahrefs account to Kimi Code via Composio Connect, so it can get domain rating trend for competitor site, list all broken backlinks for your website, find keyword volume for 'AI tools' in US, and more without ever putting your account credentials at risk.

Also integrate Ahrefs with

Why use Composio?

Composio provides:

  • Access to 1,000+ managed apps from a single MCP endpoint. This makes it convenient for agents to run cross-app workflows.
  • Managed OAuth. You do not have to worry about authentication and authorization flows for every app.
  • Programmatic tool calling. Allows LLMs to write code in a remote workbench to handle complex tool chaining. This reduces back-and-forth for frequent tool calls.
  • Large tool response handling outside the LLM context. This minimizes context bloat from large tool responses.
  • Dynamic just-in-time access to thousands of tools across hundreds of apps. Composio loads the tools your agent needs, so LLMs are not overwhelmed by tools they do not need.

Connect Ahrefs to Kimi Code

Kimi Code is a TypeScript agent distributed through npm. It acts as an MCP client and reads server definitions from an mcp.json file, and it can also add and authenticate servers conversationally through /mcp-config. Composio is a remote HTTP server that authenticates with OAuth, so no API key is stored anywhere.

1. Install Kimi Code

The quickest way is the official install script, which requires no pre-installed Node.js and places the kimi executable on your PATH.

bash
# macOS or Linux
curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash

# Windows PowerShell
irm https://code.kimi.com/kimi-code/install.ps1 | iex

# Confirm the installation
kimi --version

2. Log in

Start Kimi Code in your project directory, then sign in from the interactive UI:

bash
kimi

Run /login and choose Kimi Code OAuth using the device-code flow, or use a Moonshot API key.

3. Add Composio with /mcp-config

In current versions of Kimi Code, MCP servers are managed inside the app, not with a shell subcommand. From the interactive UI, run:

bash
/mcp-config
Kimi Code MCP config flow for adding the Composio MCP server

Tell it the server name and URL in plain language. For example:

Server name is Composio, and here is the server URL: https://connect.composio.dev/mcp

Kimi Code asks whether to add it globally, at ~/.kimi-code/mcp.json, or project-local for the current checkout, then writes the entry for you:

bash
{
  "mcpServers": {
    "Composio": {
      "url": "https://connect.composio.dev/mcp"
    }
  }
}

There is no transport field to set. Kimi Code infers HTTP from the url.

4. Restart the session

The new server is picked up on a fresh session, not the current one. Start a new session:

bash
/new

On the new session, Kimi Code detects that the server needs authorization and prompts you to run:

bash
/mcp-config login Composio

5. Authorize with OAuth

Run the command Kimi suggests:

bash
/mcp-config login composio

Kimi Code opens Composio's authorization page or surfaces a URL. Approve access, then return to the session. You should see confirmation that the Composio MCP server is connected.

Composio authorization page for Kimi Code MCP setup

Check the connection status any time with /mcp. Composio should appear as connected with its tools listed.

Kimi Code showing Composio connected after OAuth authorization

Connect your Ahrefs account

Back in a Kimi Code session, ask the agent to connect to Ahrefs or give it any Ahrefs-related task.

For example, ask it to:

  • "Get domain rating trend for competitor site"
  • "List all broken backlinks for your website"
  • "Find keyword volume for 'AI tools' in US"

It will prompt you to authenticate and authorize access to Ahrefs.

That is it. Composio tools are now available in Kimi Code, and your Ahrefs account is ready to use.

Supported Tools & Triggers

Tools
Backlinks stats retrievalRetrieves comprehensive backlink statistics for a specified website or URL using Ahrefs' Site Explorer tool.
Batch Url AnalysisPerforms a batch analysis on multiple URLs or domains using Ahrefs' powerful SEO metrics.
Domain rating for site explorerRetrieves the Domain Rating (DR) for a specified domain.
Domain rating historyRetrieves the historical Domain Rating (DR) data for a specified domain over time.
Explore keywords overviewRetrieves a comprehensive overview of keyword data from Ahrefs' Keywords Explorer tool.
Explore keyword volume by countryRetrieves the search volume data for specified keywords across different countries using Ahrefs' Keywords Explorer tool.
Explore linked domains of a siteRetrieves a list of external domains that the specified target website or URL links to, using Ahrefs' Site Explorer functionality.
Explore matching terms for keywordsThe keywords_explorer_matching_terms endpoint retrieves a list of keyword phrases that match or contain the specified keyword from Ahrefs' vast database.
Fetch all backlinksRetrieves a comprehensive list of backlinks for a specified website or URL using Ahrefs' Site Explorer tool.
Fetch broken backlinks dataRetrieves a list of broken backlinks for a specified website using Ahrefs' Site Explorer tool.
Fetch competitors overviewRetrieves a comprehensive overview of competitor data in relation to keyword rankings and organic search performance.
Fetch rank tracker overviewThe GetRankTrackerOverview endpoint retrieves a comprehensive summary of keyword rankings and SEO performance data from Ahrefs' Rank Tracker tool.
Fetch site explorer referring domainsRetrieves a list of domains that have backlinks pointing to a specified target website.
Fetch total search volume historyRetrieves the historical total search volume data for specified keywords using Ahrefs' Site Explorer tool.
Get serp overviewRetrieves a comprehensive overview of Search Engine Results Pages (SERP) data for specified keywords or queries.
Get site audit projectsRetrieves a list of Site Audit projects associated with the authenticated Ahrefs account.
Get site explorer country metricsRetrieves country-specific Site Explorer metrics for a given website from Ahrefs.
Get site explorer linked anchors externalThe site-explorer-linked-anchors-external endpoint retrieves data about external anchor texts linking to a specified target website.
Get url rating historyRetrieves the historical URL Rating data for a specified URL over time.
Linked anchors explorerRetrieves information about internal linked anchors for a specified website using the Ahrefs API.
List best by external linksThe 'get_best_by_external_links' endpoint retrieves a list of pages from a specified website, ranked by the number of external links pointing to them.
Pages by traffic overviewRetrieves a list of pages from a specified website, ordered by their estimated organic search traffic.
Retrieve anchor dataRetrieves anchor text data for a specified website or URL using Ahrefs' Site Explorer tool.
Retrieve best by internal linksRetrieves data on the best-performing internal links within a specified website using Ahrefs' Site Explorer feature.
Retrieve crawler ip rangesRetrieves the list of IP address ranges used by Ahrefs' web crawler (AhrefsBot).
Retrieve organic competitorsThe GetOrganicCompetitors endpoint in the Ahrefs API provides a comprehensive analysis of websites competing for organic search rankings with a specified target domain.
Retrieve organic keywordsRetrieves organic keywords data for a specified website using Ahrefs' Site Explorer tool.
Retrieve outlinks statsRetrieves comprehensive statistics about outgoing links (outlinks) from a specified website using Ahrefs' Site Explorer tool.
Retrieve paid pages dataRetrieves information about paid pages (PPC advertising) for a specified website using Ahrefs' Site Explorer tool.
Retrieve public crawler ipsRetrieves a list of IP addresses currently used by AhrefsBot, Ahrefs' web crawler.
Retrieve related termsThe keywords_explorer_related_terms endpoint retrieves a list of related terms for a given keyword using Ahrefs' extensive keyword database.
Retrieve site explorer keywords historyRetrieves historical keyword performance data for a specified website or domain using Ahrefs' Site Explorer.
Retrieve site explorer metricsThe GetSiteExplorerMetrics endpoint retrieves comprehensive SEO metrics for a specified website using Ahrefs' Site Explorer tool.
Retrieve site explorer metrics historyRetrieves historical SEO metrics data for a specified website over a given time period.
Retrieve site explorer pages historyThe get_site_explorer_pages_history endpoint retrieves historical data about specific pages or domains from Ahrefs' Site Explorer.
Retrieve site explorer referring domains historyRetrieves the historical data of referring domains for a specified website or URL over time.
Retrieve subscription limits and usageRetrieves detailed information about the current subscription limits and usage for an Ahrefs account.
Retrieve top pages from site explorerRetrieves data about the top-performing pages of a specified website using Ahrefs' Site Explorer tool.
Retrieve volume historyRetrieves the historical search volume data for a specified keyword using Ahrefs' Keywords Explorer tool.
Search suggestions explorerRetrieves search suggestions for a given keyword or phrase using Ahrefs' Keywords Explorer tool.

Conclusion

You have successfully connected Ahrefs to Kimi Code using Composio Connect. Your agent can now manage Ahrefs from the terminal with natural language, without exposing credentials in prompts or local scripts.

Since the same Composio endpoint exposes 1,000+ apps, you can add Slack, Calendar, Linear, and more to the same server and chain them into cross-app workflows.

How to build Ahrefs MCP Agent with another framework

OpenAI Agents SDK logo

OpenAI Agents SDK

Use Ahrefs MCP with OpenAI Agents SDK

Claude Agent SDK logo

Claude Agent SDK

Use Ahrefs MCP with Claude Agent SDK

Claude Code logo

Claude Code

Use Ahrefs MCP with Claude Code

Claude Cowork logo

Claude Cowork

Use Ahrefs MCP with Claude Cowork

Codex logo

Codex

Use Ahrefs MCP with Codex

OpenClaw logo

OpenClaw

Use Ahrefs MCP with OpenClaw

Hermes logo

Hermes

Use Ahrefs MCP with Hermes

CLI logo

CLI

Use Ahrefs MCP with CLI

Google ADK logo

Google ADK

Use Ahrefs MCP with Google ADK

LangChain logo

LangChain

Use Ahrefs MCP with LangChain

Vercel AI SDK logo

Vercel AI SDK

Use Ahrefs MCP with Vercel AI SDK

Mastra AI logo

Mastra AI

Use Ahrefs MCP with Mastra AI

LlamaIndex logo

LlamaIndex

Use Ahrefs MCP with LlamaIndex

CrewAI logo

CrewAI

Use Ahrefs MCP with CrewAI

FAQ

What are the differences in Tool Router MCP and Ahrefs MCP?

With a standalone Ahrefs MCP server, the agents and LLMs can only access a fixed set of Ahrefs tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Ahrefs and many other apps based on the task at hand, all through a single MCP endpoint.

Can I use Tool Router MCP with Kimi Code?

Yes, you can. Kimi Code fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Ahrefs tools.

Can I manage the permissions and scopes for Ahrefs while using Tool Router?

Yes, absolutely. You can configure which Ahrefs scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

How safe is my data with Composio Tool Router?

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Ahrefs data and credentials are handled as safely as possible.

Used by agents from

Context
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai
Context
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai
Context
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai

Never worry about agent reliability

We handle tool reliability, observability, and security so you never have to second-guess an agent action.

Get started for freeGet a demo↗