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.
Current release: 2.1 · Install from WordPress.org
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.
| 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.
- In WordPress admin, go to Plugins → Add Plugin and search for "SM Agent Kit"
- Click Install now, then Activate
- Go to Settings → Permalinks and click Save Changes to flush rewrite rules
- Go to SM Agent Kit in the sidebar to configure
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.
Toggle on to serve /llms.txt. Content builds from your site name, tagline, key endpoints, and recent published posts and pages.
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 modelssearch: whether search engines and AI search tools may index your contentai-input: whether AI agents may use your content as direct input when processing tasks
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.
Auto-generated from your REST API root and sitemap. Optionally add extra endpoints, one per line, to include in the catalog.
Auto-generated OpenAPI 3.1 description of your core REST endpoints, for agent frameworks that discover tools from a spec.
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.
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.
Declares what agents may do with your content across summarizing, quoting, indexing, training, and transacting, as a machine-readable counterpart to your content signals.
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.
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.
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.
Toggle on to enable Accept: text/markdown content negotiation for all singular posts and pages. No further configuration needed.
Click Test all endpoints to request every enabled endpoint from the server and see which ones respond correctly.
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.
- 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
| 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 |
- Per-field AI generation (Anthropic / OpenAI API)
- OAuth / OIDC discovery endpoints
- WebMCP support
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
This repository mirrors the release published to the WordPress.org directory. See CONTRIBUTING.md before opening a pull request.
GPLv3 or later. See LICENSE.
Built by Mo Shehu — mohammedshehu.com