Documentation
How AI Schema Gen checks your website, fixes what it finds, and keeps checking. Start at the top, or jump to the part you need.
Getting started
AI Schema Gen is an AI readiness platform. It checks whether AI systems such as ChatGPT, Perplexity, Gemini and Google's AI Overviews can reach your website, read it and tell who runs it. Then it fixes the parts it can and keeps checking so the fixes stay in place.
- 1Run the free check on your website. No account needed.
- 2Create a free account to keep the report and see the full Fixes list.
- 3Add your site under Sites: choose WordPress, Next.js or Any other website.
- 4Fill in Business Identity once: your name, contact details, area served and profiles.
- 5Open Fixes and press fix. We read each page again afterwards to confirm the fix is live.
The readiness check
Type in a web address and we read up to 100 pages, usually in under a minute. You get one AI readiness score out of 100, built from four plain questions, with the evidence behind every finding.
Discover (15% of the score)
Can AI reach your website? Your sitemap, robots.txt, page status, and pages that stay blank until JavaScript runs.
Read (15%)
Can AI make sense of each page? Headings, page titles and descriptions, canonical links, language and image descriptions.
Understand (45%)
Can AI tell who you are? Your business details, how your pages connect back to one business, and pages such as About and Contact.
Answer (25%)
Does AI describe you correctly? The AI Answer Test asks a real AI model about your business using only your website, then checks each answer against what you declared.
We load each page twice, once as a plain crawler and once in a real browser, so you can see pages that look empty to AI systems that do not run JavaScript. Every finding names the page it came from. The full scoring rules, including what we deliberately do not measure, are on the methodology page.
The Fixes list
Once your site is connected, every finding lands in one Fixes list, sorted by who can fix it.
We fix it
Pages with no structured data, references pointing at things that do not exist, and pages that never connect back to your business. One click, across the whole site.
We ask once
Your phone number, address, registered name and profiles. You answer once in Business Identity and it goes onto every page.
You change it
Things only you can change on your website, such as a missing sitemap or images without descriptions. We name the pages and explain it plainly.
What happens when you press fix
- • AI reads each page and writes the structured data that describes it, picking the most fitting of the 827+ schema.org types.
- • Each page is tied back to your one business identity, so AI sees one company instead of many loose pages.
- • Pages that already carry correct structured data are kept, not overwritten.
- • We read the page again afterwards to confirm the fix is live, not just saved.
Business Identity
Understand counts for nearly half your score, because an AI that cannot tell who runs a website will not describe it with confidence. Business Identity is where you answer those questions once. Saving it republishes your details everywhere they belong.
Who you are
Name, registered name, logo (paste a link or upload one), description, founding date and founders, and your business type, such as Plumber instead of a generic "local business".
How to reach you
Phone or email, and either your address or, if customers never visit you, the areas you serve. Service-area businesses leave the address out.
Proof it is you
Links to your profiles elsewhere, such as LinkedIn and your Google Business Profile. In structured data these are called sameAs links, and they let AI match you across the web.
What you know about
The topics you are known for, published as knowsAbout, so AI knows which questions you are a good source for.
The same page also sets up an llms.txt file (a plain summary of your site for AI systems) and clean canonical links. If you already have an About or Contact page we did not find, point us at it and we count it once we have read it.
Connect a WordPress site
The free WordPress plugin is the fullest connection: it applies every fix, and fixes new pages the moment you publish them, on every plan.
Install the plugin
- 1In your WordPress admin, go to Plugins > Add New
- 2Search for AI Schema Gen, click Install Now, then Activate
- 3Or download it from WordPress.org and upload it under Plugins > Add New > Upload Plugin
Needs WordPress 5.8 or newer and PHP 7.4 or newer.
Connect it with your API key
- 1On the dashboard, open API Keys and create a key
- 2In WordPress, go to AI Schema Gen > Settings
- 3Paste the key into the API Key field and click Save Settings
- 4A green tick confirms the connection. Your site now appears under Sites on the dashboard
In the WordPress editor
The AI Schema Gen box under the page editor shows the structured data on that page. You can generate it for just that page, edit it, and open Google's Rich Results Test with the page already filled in.
Connect a Next.js site
The @aischemagen/nextjs package puts the structured data you manage on the dashboard into your pages as part of the page itself, so AI crawlers that do not run JavaScript still see it. Pages stay pre-built and fast: a page is only refreshed when its structured data changes, within seconds and without a rebuild.
- 1Add your site under Sites, choose Next.js, and open Get Code for your publish token
- 2Run
npm install @aischemagen/nextjs - 3Add the routes and the page component shown in Get Code, and set
AISCHEMAGEN_PUBLISH_TOKENin your environment - 4Deploy, then use Check on the Sites page to confirm the connection
setup_nextjs_schema tool.Connect any other website
On Wix, Shopify, Squarespace, Webflow or a hand-built site, choose Any other website when you add it. We build the code that tells AI who your business is, straight from your Business Identity, and show paste steps for your website builder.
- 1Fill in Business Identity
- 2On Sites, open Get the code and copy it (Wix gets a version that fits its size limit)
- 3Paste it into your homepage's head section, following the steps shown for your builder
- 4If your details change later, Sites shows Get the new code so you know to paste it again
Monitoring and AI visibility
Weekly re-check
From Pro up, every connected site is checked again each week and scored the same way, so the numbers compare. If your score drops, we email you and say what changed.
AI Visibility
Add the questions your customers ask. We ask ChatGPT, Claude, Gemini, Perplexity and Google AI Overviews, and show whether your website is named or cited in the answers, week by week.
Pro tracks 10 questions, Premium 30 and Agency 80. Every plan asks all 5 engines each week, and Run check gives you 2 extra checks of every question a month on top of that (a new question's first check is always free). We never turn this into a made-up score or odds: you see the answers themselves.
Competitors, content gap and Search Console
Competitors
See how a competitor's website is set up for AI next to yours, including structured data they use that you do not. 2 on Pro, 10 on Premium, unlimited on Agency.
Content Gap
What your website claims that AI cannot confirm, questions AI answers without you, and what competitors offer that you do not. Pro and above.
Search Performance
Connect Google Search Console to see clicks and impressions per page next to the fixes you made. Pro and above.
WordPress plugins we work with
Yoast SEO, Rank Math and All in One SEO
Each adds its own structured data. While our plugin is active it switches theirs off, so your pages carry one set instead of two. Their titles, meta descriptions, sitemaps, redirects and keyword tools keep working. No setup needed.
WooCommerce
Product pages use your live store data: price, currency, stock, SKU, brand, GTIN or MPN, gallery images, and star ratings when real reviews exist.
Elementor and other page builders
Our structured data goes in the page head, so it works with any theme or builder. Elementor also gets an editor-only widget showing the page's structured data status.
Advanced Custom Fields
Values in your ACF fields can flow into your structured data. Common field names are matched for you; map the rest in the plugin settings.
Every way to connect is on the integrations page.
Schema types
We work with all 827+ types on schema.org, not just the handful Google shows as rich results, because AI systems read the whole vocabulary. The right type is picked from your website type (28 of them) and your business type (80+), then from what each page actually is: a service page, a product, a recipe, an article and so on. Browse them in the schema types directory.
Agencies and teams
- • Audited Domains: keep a readiness report for any domain without connecting it. Every plan.
- • Clients: group sites by client and open one report per client. Any paid plan.
- • Team: invite Editors and Viewers. 3 seats on Premium, unlimited on Agency.
- • Report Branding: your name, logo and colour on report pages, PDFs and exports. Agency plan.
More on the agencies page.
Plans and limits
| Feature | Free | Pro | Premium | Agency |
|---|---|---|---|---|
| Price per month | $0 | $19 | $49 | $99 |
| Connected sites | 1 | 1 | 5 | Unlimited |
| Pages fixed and looked after, per site | 25 | 500 | 2,000 | 2,000 |
| Full readiness report, any website | Yes | Yes | Yes | Yes |
| Business Identity, llms.txt, canonical links | Yes | Yes | Yes | Yes |
| Fix new pages on publish (WordPress) | Yes | Yes | Yes | Yes |
| Weekly re-check and score-drop email | No | Yes | Yes | Yes |
| AI visibility questions tracked | No | 5 | 15 | 40 |
| Competitors monitored | No | 2 | 10 | Unlimited |
| Search Console and content gap | No | Yes | Yes | Yes |
| Client grouping | No | Yes | Yes | Yes |
| Team seats | No | No | 3 | Unlimited |
| Reports with your branding | No | No | No | Yes |
| Support | Chat | Priority chat | Dedicated | Dedicated |
Each site needs its own API key. See full pricing →
Troubleshooting
The plugin says my API key is invalid
Check for spaces before or after the key when pasting. Make sure the key is still listed under API Keys on the dashboard. If that key was already used on a different site, create a new key for this one.
A fix finished but the finding is still there
Some findings clear only when we next read your whole site. Run the check again from AI Readiness. If the finding stays, the fix guide for it explains what else can cause it, such as structured data added by your theme or another plugin.
Fixes on a WordPress site are stuck or not progressing
We send fixes to your site through the WordPress REST API, so it must be reachable from outside. Visit yourdomain.com/wp-json in a browser: it should show text in curly brackets. A security plugin or firewall blocking it is the usual cause.
Business details I saved are not on my WordPress site yet
The plugin picks up dashboard changes when someone next opens your WordPress admin, or within 6 hours. Open your WordPress admin once, then check again.
Two sets of structured data in the page source
With Yoast SEO, Rank Math or All in One SEO, ours replaces theirs automatically. If you still see two, the other set is coming from your theme or a different plugin; switch off its structured data setting.
FAQ
MCP server
AI Schema Gen publishes a Model Context Protocol (MCP) server on npm as @aischemagen/mcp. It connects Claude Desktop, Claude Code, Cursor, Windsurf or any other MCP client to your account, so you can check your score, run fixes and work with structured data from your AI assistant.
Tools
get_readiness_score
Recall a site's AI readiness score and its four-question breakdown, always dated.
get_fix_plan
The ranked list of what is hurting a site's score, and which parts can be fixed for you.
apply_fix
Run a fix: fill structured data gaps, republish business details, or publish an llms.txt. Previews first. Needs the site connected.
list_missing_alt_text
Every image with no description from the last check, ready to hand to a coding assistant.
generate_schema
Generate JSON-LD for a piece of content (picks the type, or use the one you name).
analyze_content
Suggest the schema.org type and entities for content without generating full markup.
validate_schema
Check an existing JSON-LD object and report errors and warnings.
extract_schema
Fetch a live URL and return every JSON-LD block on it.
list_sites
List every site connected to this account.
list_site_pages
List a site's pages with their structured data coverage.
start_bulk_generation
Queue structured data for many pages on a site in one job.
get_bulk_job_status
Follow a bulk job until it completes.
check_usage
Your plan, what is left this month, and recent activity.
check_billing
Plan, subscription status and recent invoices, through our own billing system.
setup_nextjs_schema
Get a publish token and the exact files to add to a Next.js project, then confirm the connection.
Connecting a Next.js site through the MCP
generate_schema, start_bulk_generation and apply_fix only change a Next.js site once it is connected, so what you generate reaches the live pages. Ask your assistant to run setup_nextjs_schema: it installs the package, wires it into your pages, and after you deploy, a second call with verify: true confirms it is live. Read-only tools such as get_fix_plan work before connecting.
Install
Needs Node.js 18 or newer. Nothing to install by hand: your MCP client downloads and runs it through npx.
MCP config for Claude Desktop, Claude Code, Cursor or Windsurf
{
"mcpServers": {
"aischemagen": {
"command": "npx",
"args": ["-y", "--package=@aischemagen/mcp", "aischemagen-mcp"],
"env": {
"AISCHEMAGEN_API_KEY": "your_api_key_here"
}
}
}
}npx -y --package=@aischemagen/mcp aischemagen-mcp form shown above, not the shorter npx -y @aischemagen/mcp. On some computers, Windows especially, the short form cannot find the program inside the package.Claude Code (command line)
claude mcp add aischemagen \ --env AISCHEMAGEN_API_KEY=your_api_key_here \ -- npx -y --package=@aischemagen/mcp aischemagen-mcp
Prefer a permanent install? Run npm install -g @aischemagen/mcp, then point your MCP client's command at aischemagen-mcp instead of npx.
Chrome extension
The AI Readiness Checker is a free Chrome extension that scores the page in your current tab: what an AI system can reach, read and understand on it, the structured data it carries, and the business behind it.
localhost and on pages behind a login, places our website check cannot reach. No account is needed to see the results.Install
- 1Open the AI Readiness Checker on the Chrome Web Store
- 2Click Add to Chrome, then Add extension
- 3Pin it from the puzzle-piece menu so the icon stays visible
- 4Open any web page and click the icon
What the panel shows
Page score
A score out of 100 with an A to F grade, split into Discoverability, Readability and Understandability.
Structured data
Every block on the page with its type, status, errors and missing fields.
Business checklist
Name, logo, phone or email, address, profiles and topics, present or missing.
Crawler vs browser
Fetches the page as an AI crawler and compares it with what you see.
Plain-language findings
Each problem written up under the check it belongs to.
Recalled site score
If the site has had a full check, its score shows too, always dated, linking to the report.
Privacy
The first pass runs on your device and sends nothing. To check the structured data and business details, the extension then sends the page address, the structured data blocks it found and a small summary (heading counts, image description counts, title, meta description, text length) to the AI Schema Gen API and nowhere else. It never sends the page's HTML, its visible text, form contents, cookies or your browsing history. Full detail is in the privacy policy, and more on the Chrome extension page.
Start with the free check
See what AI can tell about your business in under a minute. No account needed.