Documentation
Getting AdvisorSEO working
Connect it once inside Claude or ChatGPT, add your website, and from then on you ask for what you want in plain English. This page covers connecting, the lead-capture snippet, what to ask for, everything AdvisorSEO can do, how to disconnect, and how your data is handled.
1. Connect
The address you add is the same wherever you connect from:
https://mcp.advisorseo.ai/mcp
In Claude
- Add the connector. Settings → Connectors → Add custom connector, then paste the address above. You never paste an API key, a client id or a secret.
- Approve the consent screen. Sign in, choose the account workspace AdvisorSEO should work in, and approve. That workspace is bound to the connection and frozen onto it, so a later conversation cannot wander into someone else's data.
- Say “Add my website example.com”. You get a preview of exactly what will be created; confirm it and the site exists, with its own lead-form key.
In ChatGPT
- Add the connector. Settings → Connectors → Advanced → Developer mode, add a connector, and paste the same address.
- Approve the consent screen and choose your workspace, exactly as above.
- Say “Add my website example.com” and confirm the preview.
Signing up and paying happen here on advisorseo.ai. There is no checkout inside an assistant.
Then: give it a business profile
Tell it what the business does, where it works, and who it is for — “we are a two-van emergency plumber covering north Leeds, mostly landlords and letting agents”. Everything it researches and writes leans on that, so a specific profile is worth the two minutes.
Optional: let it publish to WordPress
- In WordPress, open Users → Profile → Application Passwords, create one named AdvisorSEO, and copy it.
- Give it to AdvisorSEO along with your site address. It is stored encrypted and used only to publish drafts you have approved.
- You can revoke that application password in WordPress at any time, which ends publishing immediately without touching anything else.
2. Install the lead-capture snippet
The snippet is what turns a form submission on your website into a lead in your account, attached to the page and the content that produced it.
- Get your site key. Ask: “What is the lead-form key for example.com?” Each website you add has its own.
- Put one line on your site, just before the closing
</body>tag, with your key in place ofSITE_KEY:
<script src="https://mcp.advisorseo.ai/snippet.js?key=SITE_KEY" defer></script>
On WordPress, the usual home for that line is your theme's footer, a header-and-footer snippet plugin, or the site-wide custom code box your theme provides. Ask AdvisorSEO and it will talk you through the one your site actually has.
- Submit your own form once to check the wiring, then say “show me this week's leads”. Your test should be sitting there.
What the snippet does and does not do: it watches the forms already on your page, and when one is submitted it sends the fields of that form to your account, along with a hidden honeypot field used to catch bots and a spam score. It does not read the rest of the page, it does not set advertising cookies, and it does not follow your visitors anywhere. Leads that look automated are scored and marked rather than quietly dropped, so you can check the judgement yourself.
3. Things to ask for
Plain sentences work. These are real starting points, in the order most people use them:
- “Add my website example.com, then set my profile: independent dental practice in Sheffield, private and NHS, families and nervous patients.”
- “Audit example.com and tell me the three things worth fixing first, in plain English.”
- “Find the keywords a practice my size could realistically win, and plan four articles from them.”
- “Write the first article from that plan and save it as a draft for me to read.”
- “Publish the approved draft to my WordPress site.”
- “Show me this week's leads, and mark the one I phoned as contacted.”
- “If someone asks an assistant for a dentist in Sheffield, are we named? Check it and tell me what to fix if we are not.”
Anything that changes your data, your site or a lead shows you a preview first and waits for you to say yes.
4. Everything AdvisorSEO can do
Twenty capabilities, grouped by what they touch. Ten only read; eight change your own records and ask first; one publishes to your site; one goes out and fetches a website you name.
| Capability | In plain words |
|---|---|
| Overview | A short account-wide summary: which sites, what is in flight, what changed lately. |
| List websites | Every website in your account, with the details held for each one. |
| Read business profile | What the business does, where, and who for — as AdvisorSEO currently understands it. |
| List keywords | The keyword shortlist saved for a site, and what each one is for. |
| List content plans | The ordered plan of what to write next and why. |
| List content | Your drafts and published pieces, with their state. |
| List leads | The leads your site produced, newest first, with their stage. |
| Audit history | Every audit run on a site, so you can see what improved. |
| Audit findings | What the latest audit found and what is worth fixing first. |
| Audits due | Which of your sites are overdue a fresh look. |
| Capability | In plain words |
|---|---|
| Add a website | Adds a site to your account and issues its own lead-form key. |
| Update a website | Corrects a site's address or details. |
| Set business profile | Records or revises what the business does, where and for whom. |
| Save keywords | Keeps a researched keyword shortlist against a site. |
| Save content plans | Stores the plan of what to write, in order. |
| Save a draft | Files a written piece as a draft. Nothing is public at this point. |
| Update a lead | Moves a lead through new, contacted, qualified, converted or lost, with your note. |
| Watch a site | Puts a site on a recurring audit schedule so problems surface on their own. |
| Capability | In plain words |
|---|---|
| Publish to WordPress | Posts an approved draft to your own WordPress site over the official WordPress interface, using the application password you supplied. Previews first; publishes only on your confirmation. |
| Audit a website | Fetches the pages of a website you name and reports what is wrong with them. It identifies itself honestly and reads a bounded number of pages. |
Search Console, Google Analytics 4 and page-speed readings are being folded in behind the same sign-in. They will be read-only, and they will only appear once you have granted the matching permission.
5. How to disconnect
- In Claude: Settings → Connectors → AdvisorSEO → remove it. Access ends at once.
- In ChatGPT: Settings → Connectors → AdvisorSEO → remove it.
- Stop publishing: in WordPress, Users → Profile → Application Passwords, and revoke the one named AdvisorSEO.
- Stop lead capture: delete the snippet line from your site. Nothing more is collected the moment it is gone.
- Delete what we hold: email support@advisorseo.ai and we delete your data, apart from the limited records a law requires us to keep. See the privacy policy.
Disconnecting does not touch your website, your WordPress content, or anything already published.
6. Data and safety
Sign-in is OAuth 2.1
Authorization code with PKCE, and the client registers itself — so there is no key for you to paste, copy or lose. A connection is bound to your workspace only when a human approves it on the consent screen, never by a link being opened.
One account, walled off
Your workspace is chosen by you at consent, carried in a signed token and frozen onto every request. Every single request re-checks that the site, draft or lead belongs to your workspace before anything happens. Agencies get the same wall between their clients.
WordPress credentials
The application password you supply is stored encrypted at rest, used only to publish drafts you approved, and revocable by you in WordPress at any time. We never ask for, and never store, your WordPress login password.
The snippet posts form fields only
It sends the fields of the form that was submitted, plus a honeypot field and a spam score. Not the page, not your visitors' browsing, not an advertising identifier.
What we log about usage
Internal identifiers, which capability ran, whether it succeeded, the category of any error, how long it took, and when. Kept 30 days, then deleted. No request contents, no page text, no lead details.
What we never do
We do not sell your data, do not share it between customers, and do not use it to train AI or machine-learning models. Ask us to delete it and we do.
The detail sits in the privacy policy and the terms. If something here is unclear or looks wrong, tell us — that is a bug in the writing and we would like to fix it.