Ahrefs MCP: expose the keyword list write endpoints as tools
Olaf van Gessel
Ahrefs MCP currently exposes only one tool for keyword lists:
management-keyword-list-keywords -> GET /v3/management/keyword-list-keywords
API v3 has had two write endpoints for keyword lists since 9 June 2025, and neither is available as a tool:
PUT /v3/management/keyword-list-keywords (add keywords)
PUT /v3/management/keyword-list-keywords-delete (remove keywords)
Both are documented as free and consume no API units.
Because of this gap, updating a keyword list means pasting into the web app by hand. And since an import always creates a new list instead of updating the existing one, you end up with duplicates unless you rename or delete the old one first. I maintain 31 keyword lists across two brands, so that is a lot of manual work for something the API can already do.
The GET tool is already wired up, so adding the two PUTs should be a small change.
Related gap worth considering: there is still no endpoint to create a keyword list or to list existing lists. Adding those would make keyword list management fully automatable from an agent.