Connect an AI assistant

How it works

1. Add KiwiRank to your assistant

   Every assistant asks for the same connector URL:

   https://mcp.kiwirank.com/mcpCopy

2. Sign in with KiwiRank

   Your assistant opens a KiwiRank page. Check the assistant’s name and address, choose the websites to share and the access level (read-only or full), then Allow.

3. Ask

   “Show my latest articles” or “Add ‘best CRM for agencies’ to my plan”. The assistant picks the right KiwiRank tool.

Access and safety

• Publishing starts with a preview

  Before anything goes to your site, KiwiRank answers the assistant with a preview of what will be sent and where, and tells it to ask you first. To check each send yourself, keep your assistant’s per-tool approval on.

• Never posts to Reddit

  KiwiRank finds the Reddit threads your buyers read and writes your replies. You read each one and post it yourself, from your own account.

• Read-only if you like

  When you sign in, choose read-only access and the assistant can look but never change your articles, keywords, questions or settings. It can also have KiwiRank suggest questions to track. Suggestions use your plan’s AI visibility allowance.

• Every change is logged

  Each change an assistant makes is listed in Settings › API & MCP › Activity, with the assistant’s name.

• Your plan’s limits apply

  An assistant can do what you can do in KiwiRank, within the same plan limits. It never sees billing or your site’s passwords.

• Disconnect any time

  Settings › API & MCP lists every assistant connected to the website (its owner also sees the ones editors connected). Disconnect one and it loses access at once.

Tools

Your assistant sees these tools. With read-only access it sees only the read tools. A tool that asks first answers with a preview of what it will do, and your assistant is told to ask you before it confirms. Text that comes from other people or other sites is marked as such in each answer, and the assistant is told it is not an instruction.

Tool	What it does	Access
Account
list_websites	The websites you shared with this assistant.	Read
get_account_and_usage	Plan, when it renews or ends, articles and API allowance left, and the platform your site looks built with.	Read
get_overview	Your Overview: each feature’s headline number and the next step.	Read
get_getting_started	Your getting-started checklist, connecting your website first if you own it: done, locked and next steps.	Read
hide_getting_started	Hide your getting-started checklist in KiwiRank, or show it again.	Full
list_activity	What the API and assistants changed, newest first.	Read
Articles
list_articles	Your articles, newest first, filtered by status; optionally each one’s clicks from Google Search Console.	Read
read_article	One article in full, as Markdown, with its article checks and Google Search Console figures.	Read
get_article_image	One of an article’s images, shown in the chat.	Read
get_article_progress	How far along an article you asked for is.	Read
request_article	Write a new article on a topic, after saying how many articles you have left.	Full, asks first
upload_article_image	Add your own image (up to 700 KB) to a ready article, to place with edit_article.	Full
edit_article	Change a ready article’s title, target keyword or text.	Full
list_failed_articles	Articles that failed, why, and whether each can be tried again.	Read
retry_failed_article	Try a failed article again, after saying how many articles you have left.	Full, asks first
skip_failed_title	Remove a failed article’s title from your content plan, after a preview.	Full, asks first
Publishing
get_publishing_settings	How finished articles go out, and whether your site is ready to receive them.	Read
list_publications	Articles sent to your site: published, saved as draft or refused, with the post’s link.	Read
list_webhook_deliveries	Your webhook connection and its newest deliveries: what your endpoint answered, and the next try.	Read
set_publishing_mode	Change how finished articles go out to your site.	Full, asks first to turn on Auto-publish
publish_article	Send an article to your site, after showing you exactly what will happen.	Full, asks first
get_publication_status	Whether a sent article arrived, and its address on your site.	Read
Autopilot
get_autopilot_schedule	When autopilot writes: on or paused, days, time, its pace, and a catch-up question waiting.	Read
set_autopilot_schedule	Switch autopilot on or off, pause or resume it, or change its days, time and timezone.	Full, asks first to switch it on or resume it
answer_catch_up	After a pause, write the owed articles at the normal pace or fast.	Full, asks first to choose fast
Settings
get_business_settings	Your business description, customers, content language and target market.	Read
update_business_settings	Change the description, customers, content language or target market.	Full
get_writing_settings	How new articles are written: length, perspective, instructions and article parts.	Read
update_writing_settings	Change the length, perspective, writing instructions or article parts.	Full
get_image_settings	The image styles new articles take in turns (the first is the main one) and the visual direction.	Read
update_image_settings	Change the image style, the styles to take in turns, or the visual direction.	Full
get_brand_kit	Your brand kit: name, voice, colours, fonts and imagery, and whether a logo is set.	Read
update_brand_kit	Change parts of your brand kit, such as a colour or a voice rule.	Full
refresh_brand_kit	Read your website again to rebuild the brand kit (5 times in 24 hours); it replaces your edits.	Full, asks first
Content plan
list_keywords	Your content plan: upcoming topics and their dates.	Read
add_keyword	Add a topic to your content plan.	Full
edit_keyword	Change an upcoming topic or its writing notes, or remove it.	Full, asks first to remove a keyword
get_upcoming_articles	The articles autopilot will write on the coming days, with their titles.	Read
Site health
get_site_health	The latest site-health check and the issues it found.	Read
recheck_site_health	Run a new site-health check.	Full
Reddit
find_reddit_threads	Reddit threads where people ask about what you offer.	Read
read_reddit_reply	The reply KiwiRank wrote for a thread.	Read
set_reddit_keywords	Choose what KiwiRank watches on Reddit.	Full
write_reddit_reply	Write your reply, for you to post yourself.	Full
set_reddit_thread_state	Mark a thread replied or dismissed.	Full
refresh_reddit_threads	Look for new threads now instead of at the next scheduled search, once a day.	Full
read_reddit_thread	A thread’s post and top comments; a thread not read in 30 days uses page-reading credits.	Full
Competitors
list_competitors	The competitor websites saved for your website, and which get a domain rating.	Read
add_competitor	Save another business’s website as a competitor.	Full
remove_competitor	Remove a saved competitor, after a preview. Adding it back restores it.	Full, asks first
Domain rating
get_domain_rating	Your domain rating from Ahrefs and your competitors’, with the day each was measured.	Read
Backlinks
get_backlinks	Your link exchange: links received and given, sites that link to you, whether you can join, our estimate.	Read
list_backlink_industries	The industries the link exchange matches on, and the one saved for your website.	Read
join_backlink_exchange	Join the link exchange with the industry you confirm. Needs a connected site that publishes automatically.	Full
leave_backlink_exchange	Leave the link exchange, after a preview.	Full, asks first
set_backlink_exclusions	Sites you never want links from.	Full
Traffic
get_traffic	Clicks and impressions from Google Search Console, for the last 28 days or a period you name.	Read
list_search_console_properties	The Search Console properties of the connected Google account, the best match first.	Read
set_search_console_property	Choose the Search Console property KiwiRank reads your traffic from.	Full
AI visibility
get_ai_visibility	How often AI assistants like ChatGPT mention you, by platform, question and category, and who else they name.	Read
get_ai_visibility_question	What each AI assistant answered to one tracked question, newest first.	Read
suggest_ai_visibility_questions	Questions worth tracking, picked from your website’s research.	Read
set_ai_visibility_questions	Add or remove tracked questions, up to your plan’s number (Grow 10, Scale 50).	Full
pause_ai_visibility_questions	Pause tracked questions: they keep their history and stop counting toward your plan’s number.	Full
resume_ai_visibility_questions	Ask paused questions again, up to your plan’s number.	Full
set_ai_visibility_question_intent	Change what kind of question one is: buying, comparison, alternatives, brand, reviews or category.	Full
set_ai_visibility_question_country	Choose the country questions are asked from, or go back to your website’s market.	Full
get_ai_visibility_citations	The websites AI answers cite for your questions, and the sites to get mentioned on.	Read
create_ai_visibility_category	Make a category to group your questions, like one per product line.	Full
update_ai_visibility_category	Rename or recolour a category.	Full
reorder_ai_visibility_categories	Put your categories in a new order.	Full
delete_ai_visibility_category	Delete a category; its questions stay tracked, with no category.	Full, asks first
move_ai_visibility_questions	Put questions into a category, or take them out of every category.	Full
suggest_ai_visibility_categories	Suggest categories (nothing saved); each call, a retry too, spends a little AI visibility allowance, 5 a day.	Full
apply_ai_visibility_categories	Put questions into categories in one step, making the missing ones; questions can leave another category.	Full, asks first
Monthly summary
get_monthly_summary	A month’s summary: articles, AI mentions, Google clicks and domain rating, with the PDF’s address.	Read
email_monthly_summary	Email the monthly summary as a PDF to your own login email, after naming the address.	Full, asks first
White-label
get_agency_brand	Your agency branding for client summaries: name, colours, support email and logo address.	Read
set_agency_brand	Save your agency’s name, colours and support email for every client’s summary, after naming the changes.	Full, asks first
remove_agency_brand	Remove the agency branding and logo: summaries go back to KiwiRank’s look.	Full, asks first
upload_agency_logo	Set the agency logo from an image file (700 KB here, 1 MB with an API key), after saying what it replaces.	Full, asks first
Clients
list_clients	Your clients for this website’s read-only dashboard: email, access, status.	Read
invite_client	Invite a client: a sign-in link mailed under your agency’s name, after naming the address.	Full, asks first
resend_client_invite	Mail a pending client a new sign-in link; the earlier link stops working.	Full, asks first
remove_client	End a client’s access to the dashboard at once.	Full, asks first
Team
get_team	Your workspace’s owner, members and open invites, with the seats used and allowed.	Read
invite_teammate	Invite someone to your workspace as a Member: a 7-day link by email, after naming the address.	Full, asks first
resend_team_invite	Mail an open invite again with a new link; the earlier link stops working.	Full, asks first
revoke_team_invite	Cancel an open invite: its link stops working and its seat is free again.	Full, asks first
remove_teammate	Remove a member from your workspace at once (never the owner).	Full, asks first

Like the app, the AI visibility figures leave out questions that name your brand or your domain, because AI answers to those are about you. To count them, ask your assistant to include them: get_ai_visibility and get_ai_visibility_citations take an optional branded argument, exclude (the default) or include.

Connect with an API key

For a tool that cannot sign in with OAuth, send a KiwiRank API key as a bearer token to the same URL. The key’s access level applies, and its name shows in the activity list.

{
  "mcpServers": {
    "kiwirank": {
      "url": "https://mcp.kiwirank.com/mcp",
      "headers": {
        "Authorization": "Bearer kr_live_…"
      }
    }
  }
}

Troubleshooting

Sign-in opens but the assistant says it could not connect

Check the URL ends in /mcp, with no trailing slash or spaces. In Claude, edit the connector and set OAuth client to Register automatically, then sign in again.

No websites to choose when I sign in

You can share websites where you are an owner or editor and that have an active plan. Check Settings › Billing for the website.

The assistant can read but not change anything

You chose read-only access. Disconnect the assistant in Settings › API & MCP and connect it again with full access.

It worked yesterday and now asks me to sign in

A connection lasts 30 days from when you connected it, and a disconnected assistant must sign in again. Sign in once more; nothing else changes.

ChatGPT does not offer “Add custom MCP server”

Custom MCP servers need a Business, Enterprise or Edu workspace (on Business, an admin or owner adds them), or Pro for read tools only.

Claude says only an owner can add connectors

On Team and Enterprise, an owner adds KiwiRank once in Organization settings › Connectors. Members then select Connect.

Cursor does not open the sign-in page

Open Cursor’s MCP settings, find KiwiRank and select it to sign in, or check that ~/.cursor/mcp.json is valid JSON.

Still stuck? Write to support@kiwirank.com with the assistant’s name and what it said.