{
  "markdown": "# Shilpi MCP server\n\n[![Listed on mcpservers.org](https://mcpservers.org/badge.svg)](https://mcpservers.org/servers/shilpibuilder-com-docs)\n\nConnect Claude, ChatGPT or any MCP-capable agent to a WordPress site running the\n[Shilpi](https://shilpibuilder.com/) theme, and let it build and edit that site\nthrough scoped abilities rather than server access.\n\nThis repository holds the public interface: the registry manifest, the tool\nlist, the authentication guide and example client configurations. The server\nitself ships inside the Shilpi theme and runs on your own WordPress install, so\nthere is no service to sign up for and no third party sits between the agent and\nyour site.\n\n- Product and pricing: <https://shilpibuilder.com/>\n- Documentation: <https://shilpibuilder.com/docs/>\n- Permission model, explained: <https://shilpibuilder.com/abilities-not-access/>\n\n## Why this exists\n\nMost WordPress page builders store a layout in their own format. An agent asked\nto edit such a page has to learn a proprietary widget tree, guess at its\ninvariants and hope the vendor does not change them.\n\nShilpi stores a page as three plain fields: body HTML, a real stylesheet, and\nfocused JavaScript. An agent editing a Shilpi page is editing markup it already\nunderstands. What it needs from the site is not raw access but vocabulary: which\nglobal classes exist, which design variables are defined, and what the house\nrules are. That is what these tools provide.\n\n## Endpoints\n\nThe server runs on your own site. Replace `example.com` with your domain.\n\n| Purpose | URL |\n| --- | --- |\n| Streamable HTTP, OAuth | `https://example.com/wp-json/mcp/shilpi-oauth` |\n| Streamable HTTP, application password | `https://example.com/wp-json/shilpi/v1/mcp` |\n| OAuth protected-resource metadata | `https://example.com/wp-json/shilpi/v1/oauth/protected-resource` |\n| Site summary for agents | `https://example.com/llms.txt` |\n\nBoth endpoints require an active licence. Without one they return 404, and no\ncredential will authenticate. Switching the server off in\n**Shilpi → Dashboard → Connect an AI agent** removes both endpoints, which makes\nit a genuine kill switch rather than a setting.\n\n## Requirements\n\n- WordPress 6.4 or newer\n- PHP 8.0 or newer\n- HTTPS, required for OAuth\n- The Shilpi theme, active, with a valid licence\n\n## Getting connected\n\nSee [docs/authentication.md](docs/authentication.md) for the OAuth flow and the\napplication-password fallback, and [examples/](examples/) for ready-to-paste\nclient configuration.\n\n## Abilities\n\nEvery tool is scoped. There is no filesystem access, no SSH, and no route to\n`wp-config.php` or to theme and plugin files. Writing PHP snippets is a\ntemporary permission the site owner grants at **Shilpi → Security** and revokes\nin one click.\n\nThe list below is generated from a live install running Shilpi 1.9.4. Counts\nchange between releases, and the WooCommerce Kit plugin adds its own tools when\nit is active.\n\n### Pages, posts and templates\n\n| Tool | What it does |\n| --- | --- |\n| `shilpi-site-info` | Site identity, versions, inventory, breakpoints, limits, template routing |\n| `shilpi-list-pages` | List pages, posts and templates with ids, slugs and permalinks |\n| `shilpi-get-page` | Read one document: body HTML, page CSS, page JS, header and footer |\n| `shilpi-save-page` | Create or update a page, post or template, idempotent by slug |\n| `shilpi-set-page-code` | Set a document's page CSS and JavaScript |\n| `shilpi-delete-page` | Remove a document |\n| `shilpi-import-page` | Import one static HTML file as a Shilpi document |\n| `shilpi-import-site` | Import a folder of static HTML: templates, CSS, images and menu |\n\n### Design system\n\n| Tool | What it does |\n| --- | --- |\n| `shilpi-manage-variables` | List and upsert design tokens, with per-breakpoint values |\n| `shilpi-manage-classes` | List and manage global CSS classes and their states |\n| `shilpi-get-globals` | Read global CSS and JS, and the default header, footer and front page |\n| `shilpi-set-globals` | Write those global settings |\n\n### Structure and content\n\n| Tool | What it does |\n| --- | --- |\n| `shilpi-manage-menu` | Create and order navigation menus, assign them to locations |\n| `shilpi-manage-taxonomy` | Manage categories, tags and custom taxonomies |\n| `shilpi-get-seo` | Read title, description, canonical, robots and social fields |\n| `shilpi-set-seo` | Write them through whichever SEO plugin the site runs |\n| `shilpi-upload-media` | Sideload an image into the media library, idempotent by source URL |\n| `shilpi-search-icons` | Search the installed icon libraries |\n| `shilpi-manage-icon-libraries` | Add and remove icon libraries |\n\n### Code and assets\n\n| Tool | What it does |\n| --- | --- |\n| `shilpi-list-php-snippets` | List Code Hub snippets with their enabled and error state |\n| `shilpi-get-php-snippet` | Read one snippet and its content hash |\n| `shilpi-save-php-snippet` | Create or update a snippet, syntax-checked, hash-guarded |\n| `shilpi-configure-php-snippet` | Enable or disable a snippet, test-run before enabling |\n| `shilpi-delete-php-snippet` | Remove a snippet |\n| `shilpi-list-script-files` | List managed JavaScript files |\n| `shilpi-upload-script-file` | Upload a trusted library or bundle |\n| `shilpi-configure-script-file` | Set enabled state, load priority and jQuery dependency |\n| `shilpi-list-project-files` | List project JSON and asset files |\n| `shilpi-upload-project-file` | Upload generated JSON, returns a same-origin URL |\n| `shilpi-delete-project-file` | Remove a project or script file |\n| `shilpi-set-site-manifest` | Activate a web-app manifest |\n| `shilpi-list-fonts` | List self-hosted font faces |\n| `shilpi-upload-font` | Upload a WOFF2, WOFF, TTF or OTF face and register it |\n| `shilpi-delete-font` | Remove a font face |\n\n### Agent instructions\n\n| Tool | What it does |\n| --- | --- |\n| `shilpi-get-skill` | Load a Markdown skill: `shilpi-theme` or `wordpress-core` |\n\nSkills are how the site tells the agent its own conventions. You can upload your\nown Markdown skill to add house rules, and the agent reads it before writing.\n\n## What the server cannot do\n\nThis is the part worth reading before you connect anything.\n\n- No filesystem access. It cannot read or write theme or plugin files.\n- No shell, no SSH, no `wp-config.php`.\n- No customers, orders, addresses or payment data through the WooCommerce tools.\n- Writing PHP is off by default and is a permission with an off switch, not a\n  setting you enable and forget.\n- Uploading JavaScript requires an account with `unfiltered_html`.\n\n## Licence\n\nThe contents of this repository (manifest, docs and examples) are released under\nthe MIT licence. The Shilpi theme itself is commercial software; see\n<https://shilpibuilder.com/pricing/>.\n",
  "bytes": 6766,
  "sha": "57d809991a27cac6695ca6ee71688ebc9091303a48d08e8cf08708eb2449eb6e",
  "repo_slug": "shilpibuilder/shilpi-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_shilpibuilder_shilpi_6a3ab92a/readme"
}