Skip to content

About

Agent-readiness toolkit for WordPress: markdown negotiation, llms.txt, content signals, and well-known JSON endpoints for AI agents.

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

11 Commits

Folders and files

Repository files navigation

SM Agent Kit

A WordPress plugin that makes your site readable and discoverable by AI agents. Implements emerging agentic web standards (markdown negotiation, llms.txt, content signals, and well-known JSON endpoints) with a settings UI and zero hardcoding.

WordPress Plugin Version WordPress Plugin Active Installs License: GPL v3

Current release: 2.1 · Install from WordPress.org

What it does

AI agents don't browse the web the way humans do. They request structured data, negotiate content formats, and look for standardised discovery endpoints. SM Agent Kit adds all of this to any WordPress site automatically.

Markdown negotiation. When an agent sends a request with Accept: text/markdown, your site returns the post or page as clean markdown instead of HTML, with a Content-Type: text/markdown header and x-markdown-tokens: 1. Human visitors never notice a thing.

llms.txt. Serves a plain-text /llms.txt file per the llmstxt.org convention, listing your key endpoints, recent posts, and pages for LLMs that read this file directly instead of crawling.

Content signals and per-agent crawl rules. Adds a Content-Signal directive to your robots.txt declaring your preferences for AI training, search indexing, and agent input. You can also set individual Allow or Disallow rules for named AI crawlers such as GPTBot, ClaudeBot, and PerplexityBot.

Agent metadata. Optionally injects WebSite and Organization JSON-LD into every page's head, giving AI search tools structured entity and contact information alongside your existing SEO plugin's output.

Diagnostics. A "Test all endpoints" button in the admin UI checks every endpoint from the server and reports whether each one responds correctly, so you get immediate feedback after saving settings and flushing permalinks.

Endpoints

Endpoint Purpose
/llms.txt Plain-text site summary for LLMs (llmstxt.org)
/.well-known/api-catalog Lists your REST API and sitemap endpoints (RFC 9727)
/.well-known/mcp/server-card.json Declares MCP server capabilities (SEP-1649)
/.well-known/agent-skills/index.json Lists what your site can do as an agent-callable service
/.well-known/openapi.json OpenAPI 3.1 description of your core REST endpoints
/.well-known/agent-policy.json Machine-readable usage policy for summarizing, quoting, indexing, training, and transacting
/.well-known/agentic-commerce/product-feed.json Read-only WooCommerce product feed for agent shopping tools
/.well-known/ucp/manifest.json UCP commerce capability manifest
/.well-known/acp/manifest.json ACP commerce capability manifest
/acp/checkout_sessions Stubbed ACP checkout, returns a clear not-implemented response

Every endpoint builds dynamically from your WordPress data (site name, tagline, registered post types, REST API root, product catalog) with no hardcoding required. Install on multiple sites and each one generates correct, site-specific output automatically.

Installation

  1. In WordPress admin, go to Plugins → Add Plugin and search for "SM Agent Kit"
  2. Click Install now, then Activate
  3. Go to Settings → Permalinks and click Save Changes to flush rewrite rules
  4. Go to SM Agent Kit in the sidebar to configure

Settings

The plugin adds an SM Agent Kit item to the WordPress admin sidebar. All settings save to the database and generate output dynamically, so no file editing is required.

llms.txt

Toggle on to serve /llms.txt. Content builds from your site name, tagline, key endpoints, and recent published posts and pages.

Content signals

Toggle the Content-Signal directive on or off, and set values for each field:

  • ai-train: whether AI companies may use your content to train their models
  • search: whether search engines and AI search tools may index your content
  • ai-input: whether AI agents may use your content as direct input when processing tasks

Per-agent crawl rules

Set an Allow or Disallow rule for each named AI crawler. Rules append to robots.txt through the do_robotstxt action, so they coexist with any SEO plugin that manages the file.

API catalog

Auto-generated from your REST API root and sitemap. Optionally add extra endpoints, one per line, to include in the catalog.

OpenAPI spec

Auto-generated OpenAPI 3.1 description of your core REST endpoints, for agent frameworks that discover tools from a spec.

MCP server card

Auto-generated from your site name and tagline. Optionally override the version string or add a contact email. If the contact email field is blank, it's omitted from the output entirely.

Agent skills index

Auto-detects all public post types and generates a skills entry for each. You can override the description for any post type or uncheck it to exclude it from the index.

Agent policy

Declares what agents may do with your content across summarizing, quoting, indexing, training, and transacting, as a machine-readable counterpart to your content signals.

Agent metadata (JSON-LD)

Optionally injects WebSite and Organization JSON-LD into the page head. Add same-as profile URLs, one per line, to link your social and directory profiles to the entity.

Agentic commerce

If WooCommerce is active, publishes a read-only feed of your published products: name, price, currency, availability, SKU, and URL. No checkout or payment functionality is exposed. If WooCommerce isn't installed, this section and the protocol manifests section are greyed out with a prompt to install it.

Protocol manifests

Publishes UCP and ACP manifests declaring your commerce capabilities to AI shopping agents. A stubbed checkout endpoint at /acp/checkout_sessions returns a clear "not implemented" response. No payment processing is implemented in this plugin. Live agent checkout requires a separate payment provider integration (for example Stripe's ACP tooling), which is outside the scope of this plugin.

Markdown negotiation

Toggle on to enable Accept: text/markdown content negotiation for all singular posts and pages. No further configuration needed.

Diagnostics

Click Test all endpoints to request every enabled endpoint from the server and see which ones respond correctly.

After saving settings

Any change that affects the well-known endpoints requires a permalink flush to take effect. The settings page reminds you of this after every save, with a direct link to Settings → Permalinks.

Compatibility

  • WordPress 6.0+, tested up to 7.0
  • PHP 7.4+
  • Works with any theme
  • Compatible with AIOSEO, Yoast SEO, and other robots.txt managers

Standards implemented

Standard Reference
Markdown content negotiation Accept: text/markdown, Content-Type: text/markdown
llms.txt llmstxt.org
Content Signals contentsignals.org
API Catalog RFC 9727
MCP Server Card SEP-1649
OpenAPI 3.1.0
Agent Skills Discovery Agent Skills Discovery RFC v0.2.0
Agentic commerce UCP and ACP manifests

Roadmap

  • Per-field AI generation (Anthropic / OpenAI API)
  • OAuth / OIDC discovery endpoints
  • WebMCP support

File structure

sm-agent-kit/
├── sm-agent-kit.php       main plugin file, hooks, and endpoint logic
├── admin/
│   └── settings.php       WP Admin settings page
├── assets/
│   ├── admin.css          settings page styles
│   └── admin.js           settings page behaviour and diagnostics
└── readme.txt             WordPress.org directory listing

Contributing

This repository mirrors the release published to the WordPress.org directory. See CONTRIBUTING.md before opening a pull request.

Licence

GPLv3 or later. See LICENSE.


Built by Mo Shehu — mohammedshehu.com

About

Agent-readiness toolkit for WordPress: markdown negotiation, llms.txt, content signals, and well-known JSON endpoints for AI agents.

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages