Documentation
Kortex for Claude: setup, tools and examples
The Kortex connector lets Claude check how ChatGPT, Gemini, Claude and Google answer about your business, read your Kortex reports, write the fixes and posts, and read competitors' ads, all from a chat in Claude, signed in with your own Kortex account.
What does the Kortex connector do in Claude?
It gives Claude your Kortex account: your reports, live checks of what AI assistants and Google say, post writing, and reads of competitors' ads.
Kortex is an agent for getting a business named in AI answers and on Google. With the connector, Claude can use Kortex's tools in the middle of any chat. Claude can also make the fixes itself where it has access to your site's code or files, then tell Kortex they are done.
The connector works through your Kortex account. It sees what your account sees and nothing else.
What do I need before I connect?
A Kortex account, which is free and uses Google sign-in. Nothing else is required.
- A Kortex account. If you do not have one, you make it during the connect step by signing in with Google. A new account starts with 50 free credits.
- A Claude plan that allows connectors. Connectors are added in Claude under Settings, then Connectors.
- Optional: a connected WordPress blog. Connect it inside Kortex if you want Claude to put posts on your blog. Without it, Claude still writes the posts and hands you the text.
- Optional: Google Search Console. Connect it inside Kortex if you want Claude to read your own search clicks and visits from AI assistants.
You do not need a Meta Ads or Google Ads account. The connector does not read or change your ad accounts. Competitors' ads are read from Meta's public Ad Library.
How do I connect Kortex to Claude?
Add the connector in Claude, press Connect, sign in to Kortex with Google, and press Allow.
- In Claude, open Settings, then Connectors.
- Find Kortex in the directory and press Connect. To add it by hand, choose Add custom connector and paste this address: https://app.kortexagent.co/api/mcp
- A Kortex page opens in your browser. Sign in with Google.
- Kortex shows which app is asking and what it will be able to do. Press Allow. Press Cancel if you did not start this.
- You are sent back to Claude. In a chat, turn Kortex on from the tools menu and ask your first question.
In Claude Code, run claude mcp add --transport http kortex https://app.kortexagent.co/api/mcp and then type /mcp, pick Kortex and sign in the same way.
There is no key or password to paste. Kortex never sees your Google password, and Claude never sees your Kortex sign-in.
What can Claude do with Kortex?
Read your reports, run live checks, start audits, write posts and read competitors' ads. Only a few tools change anything, and they are listed below.
- Your reports
- What Claude can do: Read your SEO and AI visibility report, its fixes with the exact text and ready-to-paste structured data, your content plan and your competitor ad reports.
- Changes anything?: No
- What Kortex knows
- What Claude can do: Read what Kortex has learned about your business (website, what you sell, your market) and the notes you asked it to follow.
- Changes anything?: No
- Live checks
- What Claude can do: Ask ChatGPT, Gemini and Claude one question and see who they name. Read Google page one and its AI Overview for one search. Check what AI crawlers see on one of your pages.
- Changes anything?: No. Costs credits.
- Audits
- What Claude can do: Start a full SEO and AI visibility audit for a website and follow it until it is done.
- Changes anything?: Makes a new report. Costs credits.
- Web reading
- What Claude can do: Search the web, open a page and read it, read a store's products, detect what a site runs on, find pages where your business could be mentioned.
- Changes anything?: No
- Competitors' ads
- What Claude can do: Read any advertiser's live Meta ads by name from Meta's Ad Library, read the page an ad sends people to, and see what your competitors started or stopped since a date.
- Changes anything?: No. Costs credits.
- Your own search data
- What Claude can do: Read your Google Search Console numbers and visits from AI assistants, if you connected Google inside Kortex.
- Changes anything?: No
- Posts
- What Claude can do: Write a post that answers one question people ask, for your blog, LinkedIn, Medium or Reddit. Put a blog post on your connected blog as a draft, or live after you say yes.
- Changes anything?: Yes: writes drafts. Publishing live asks first.
- Weekly work
- What Claude can do: Turn your weekly visibility check and your weekly blog post on or off.
- Changes anything?: Yes: a setting in your Kortex account.
- Tracked questions
- What Claude can do: Read the questions you track and their numbers month by month. Add or remove a question, or set a target.
- Changes anything?: Yes: your list in your Kortex account.
- Watching advertisers
- What Claude can do: Start or stop watching an advertiser's ads, and list what is being watched.
- Changes anything?: Yes: a setting in your Kortex account.
- Fixes
- What Claude can do: Mark a fix from your report as done once it is live on your site.
- Changes anything?: Yes: updates your report.
| Group | What Claude can do | Changes anything? |
|---|---|---|
| Your reports | Read your SEO and AI visibility report, its fixes with the exact text and ready-to-paste structured data, your content plan and your competitor ad reports. | No |
| What Kortex knows | Read what Kortex has learned about your business (website, what you sell, your market) and the notes you asked it to follow. | No |
| Live checks | Ask ChatGPT, Gemini and Claude one question and see who they name. Read Google page one and its AI Overview for one search. Check what AI crawlers see on one of your pages. | No. Costs credits. |
| Audits | Start a full SEO and AI visibility audit for a website and follow it until it is done. | Makes a new report. Costs credits. |
| Web reading | Search the web, open a page and read it, read a store's products, detect what a site runs on, find pages where your business could be mentioned. | No |
| Competitors' ads | Read any advertiser's live Meta ads by name from Meta's Ad Library, read the page an ad sends people to, and see what your competitors started or stopped since a date. | No. Costs credits. |
| Your own search data | Read your Google Search Console numbers and visits from AI assistants, if you connected Google inside Kortex. | No |
| Posts | Write a post that answers one question people ask, for your blog, LinkedIn, Medium or Reddit. Put a blog post on your connected blog as a draft, or live after you say yes. | Yes: writes drafts. Publishing live asks first. |
| Weekly work | Turn your weekly visibility check and your weekly blog post on or off. | Yes: a setting in your Kortex account. |
| Tracked questions | Read the questions you track and their numbers month by month. Add or remove a question, or set a target. | Yes: your list in your Kortex account. |
| Watching advertisers | Start or stop watching an advertiser's ads, and list what is being watched. | Yes: a setting in your Kortex account. |
| Fixes | Mark a fix from your report as done once it is live on your site. | Yes: updates your report. |
What will the connector not do?
It does not touch your ad accounts, does not publish without asking, and does not make images.
- It does not read or change your Meta Ads or Google Ads accounts.
- It does not put a post live on your blog unless you say yes in the chat. Drafts are the default.
- It does not make ad images or any other pictures. Kortex makes ads only inside its own app.
- It does not see your conversation with Claude. Kortex receives only what Claude sends to a tool, such as the question to check or the page to read.
- It does not reach anything outside your own Kortex account.
What can I ask? Example prompts
Ask in plain words. These five work as written once you replace the parts in brackets.
- "What does Kortex know about my business, and what are the top fixes in my visibility report?"
- "Ask the AI engines which [product type] to buy in [country], and tell me whether we are named and who is named instead."
- "Check [page address] for AI crawlers and tell me what to change."
- "Read the live Meta ads of [competitor name] and summarise their offers and how long each ad has been running."
- "Write a blog post that answers [question from my report], and save it to my blog as a draft."
If you use Claude Code or another tool that can edit your site, you can go one step further: "Apply the first fix from my Kortex report to this site, then mark it done."
What does it cost?
The connector itself is free to add. The work is paid for with Kortex credits, the same as in Kortex's own chat.
- A new account starts with 50 free credits.
- Reading something (a report, a web page, your search data) costs 1 credit.
- Live checks and audits cost more: 2 to 5 credits for a check, 12 for a full audit. The tool tells Claude the price, and Claude asks you before it runs one that needs your yes.
- A check that fails gives its credits back.
- Each connection can make 500 calls a day. The count resets at midnight UTC.
Your balance and every deduction are on the Usage page in Kortex. Plans with monthly credits are on pricing.
How do I disconnect Kortex from Claude?
Remove the connector in Claude, or revoke it in Kortex. Either one ends the connection.
- In Claude: Settings, then Connectors, then remove Kortex.
- In Kortex: open Settings, find Your AI tool, and revoke the entry named Claude. It stops working at once, even if Claude still lists the connector.
To have your Kortex data deleted, follow the steps on the data deletion page or write to human@kortexagent.co.
Something is not working. How do I fix it?
Most problems are an expired sign-in step, no credits left, or the daily limit.
- "This link has expired" on the Kortex page
- What it means: The connect step was left open for more than 15 minutes, or was already used.
- What to do: Go back to Claude and press Connect again.
- Claude says the connector needs to be reconnected
- What it means: The connection was revoked in Kortex, or has not been used for 90 days.
- What to do: Press Connect in Claude and sign in again.
- "Out of Kortex credits"
- What it means: Your balance is too low for that tool.
- What to do: See your balance on the Usage page in Kortex. Get more by sharing your referral link or from the pricing page.
- "Used its 500 calls for today"
- What it means: The connection reached its daily limit.
- What to do: Wait until midnight UTC. Asking Claude for one report instead of many small reads uses fewer calls.
- A tool says it needs your website
- What it means: Kortex does not know your site yet.
- What to do: Tell Claude your website address in the same message and ask again.
- "No blog connected"
- What it means: Publishing needs a connected WordPress blog.
- What to do: Connect your blog inside Kortex, or ask Claude for the post text instead.
- "Not open to your account yet"
- What it means: Sign-in for connectors is not switched on for your account.
- What to do: Write to human@kortexagent.co.
- The sign-in page keeps coming back
- What it means: Your browser is blocking cookies for kortexagent.co.
- What to do: Allow cookies for visibility.kortexagent.co and try again.
| What you see | What it means | What to do |
|---|---|---|
| "This link has expired" on the Kortex page | The connect step was left open for more than 15 minutes, or was already used. | Go back to Claude and press Connect again. |
| Claude says the connector needs to be reconnected | The connection was revoked in Kortex, or has not been used for 90 days. | Press Connect in Claude and sign in again. |
| "Out of Kortex credits" | Your balance is too low for that tool. | See your balance on the Usage page in Kortex. Get more by sharing your referral link or from the pricing page. |
| "Used its 500 calls for today" | The connection reached its daily limit. | Wait until midnight UTC. Asking Claude for one report instead of many small reads uses fewer calls. |
| A tool says it needs your website | Kortex does not know your site yet. | Tell Claude your website address in the same message and ask again. |
| "No blog connected" | Publishing needs a connected WordPress blog. | Connect your blog inside Kortex, or ask Claude for the post text instead. |
| "Not open to your account yet" | Sign-in for connectors is not switched on for your account. | Write to human@kortexagent.co. |
| The sign-in page keeps coming back | Your browser is blocking cookies for kortexagent.co. | Allow cookies for visibility.kortexagent.co and try again. |
For anything else, write to human@kortexagent.co with what you asked Claude and what came back. A person replies.
What data does Kortex receive and keep?
Only what Claude sends to a tool, and a record of which tool was called and when.
Kortex receives the inputs of each tool call, such as a question, a page address or an advertiser's name. It does not receive the rest of your conversation. It keeps a log of calls (the tool, the time, whether it worked) to count your daily limit and your credits. Reports and posts made through the connector are saved in your Kortex account like any others.
Sign-in uses the standard OAuth 2.0 flow with PKCE. Claude holds a token that expires and is renewed; Kortex stores only a one-way hash of it. The full policy is on the privacy page, and how Kortex connects to other services is on security and access.
Questions
Frequently asked questions
Do I need a paid Kortex plan to use Kortex in Claude?
You need a Kortex account and credits. A new account starts with 50 free credits, and plans with monthly credits are on the pricing page.
Can Claude change my ads through Kortex?
No. The connector does not read or change your Meta Ads or Google Ads accounts. It reads competitors' ads from Meta's public Ad Library.
Can Claude publish to my blog through Kortex?
Only if you connected your blog inside Kortex, and only after you say yes in the chat. By default a post is saved as a draft.
Does Kortex see my Claude conversations?
No. Kortex receives only what Claude sends to a tool, such as the question to check or the page to read.
Does the Kortex connector work in other AI tools?
Yes. The same address works in any tool that supports remote MCP connectors with sign-in. Tools that only accept a key can use one from Settings in Kortex, under Your AI tool.
Read next
- AI visibility auditCheck if ChatGPT, Gemini, Claude and Google name your company for the questions your customers ask, who they name instead, and get the fixes written for free.
- Security and accessHow Kortex connects to Meta and Google Ads through their own sign-in screens, with no passwords, what it can and cannot change, and how to remove its access.
- PricingThe SEO and AI visibility audit is free. Growth is $49 a month with 10 blog posts written for you. Scale is $499 a month. Enterprise is priced for your team.
Start with a free AI visibility audit
20 questions your customers ask, put to ChatGPT, Gemini and Claude, plus Google, and four fixes written for you. Free, one per website.