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.

  1. 1Run the free check on your website. No account needed.
  2. 2Create a free account to keep the report and see the full Fixes list.
  3. 3Add your site under Sites: choose WordPress, Next.js or Any other website.
  4. 4Fill in Business Identity once: your name, contact details, area served and profiles.
  5. 5Open Fixes and press fix. We read each page again afterwards to confirm the fix is live.
What is structured data? It is a short block of code in a page's head, in a format called JSON-LD, that states facts about the page and the business behind it in words a machine can read without guessing. It is also called schema markup, after the shared vocabulary it uses from schema.org. You never have to write it yourself.

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.
Your plan sets how many pages per site we fix and look after: 25 on Free, 500 on Pro, 2,000 on Premium and Agency. A page counts once it carries our structured data; fixing it again later does not count twice. For every finding there is a step-by-step fix guide.

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.

On WordPress, these details also appear in the plugin's settings and sync both ways. Changes saved on the dashboard reach the plugin the next time someone opens your WordPress admin, or within 6 hours.

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

  1. 1In your WordPress admin, go to Plugins > Add New
  2. 2Search for AI Schema Gen, click Install Now, then Activate
  3. 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

  1. 1On the dashboard, open API Keys and create a key
  2. 2In WordPress, go to AI Schema Gen > Settings
  3. 3Paste the key into the API Key field and click Save Settings
  4. 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.

  1. 1Add your site under Sites, choose Next.js, and open Get Code for your publish token
  2. 2Run npm install @aischemagen/nextjs
  3. 3Add the routes and the page component shown in Get Code, and set AISCHEMAGEN_PUBLISH_TOKEN in your environment
  4. 4Deploy, then use Check on the Sites page to confirm the connection
Needs the App Router (Next.js 13.4 or newer) on a host with a running server. An AI coding assistant can do all of this for you through the MCP server's 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.

  1. 1Fill in Business Identity
  2. 2On Sites, open Get the code and copy it (Wix gets a version that fits its size limit)
  3. 3Paste it into your homepage's head section, following the steps shown for your builder
  4. 4If your details change later, Sites shows Get the new code so you know to paste it again
Copy-and-paste sites get the business details code for the homepage. Page-by-page fixes need the WordPress plugin or the Next.js package for now.

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

FeatureFreeProPremiumAgency
Price per month$0$19$49$99
Connected sites115Unlimited
Pages fixed and looked after, per site255002,0002,000
Full readiness report, any websiteYesYesYesYes
Business Identity, llms.txt, canonical linksYesYesYesYes
Fix new pages on publish (WordPress)YesYesYesYes
Weekly re-check and score-drop emailNoYesYesYes
AI visibility questions trackedNo51540
Competitors monitoredNo210Unlimited
Search Console and content gapNoYesYesYes
Client groupingNoYesYesYes
Team seatsNoNo3Unlimited
Reports with your brandingNoNoNoYes
SupportChatPriority chatDedicatedDedicated

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.

You need an API key, which you can create free under API Keys.

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"
      }
    }
  }
}
Use the full 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.

Because it reads the page your browser has already loaded, it works on staging sites, on localhost and on pages behind a login, places our website check cannot reach. No account is needed to see the results.

Install

  1. 1Open the AI Readiness Checker on the Chrome Web Store
  2. 2Click Add to Chrome, then Add extension
  3. 3Pin it from the puzzle-piece menu so the icon stays visible
  4. 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.