Skip to main content
Glama

JalinWP

Made with passion from Malaysia 🇲🇾

An open-source MCP gateway for WordPress and WooCommerce. Connect an AI client to your site using OAuth, retrieve permitted information, and choose how changes are applied.

This public repository at github.com/fatomate/jalinwp contains JalinWP 0.3.3, its complete plugin source, local test harnesses, documentation, and release tooling. Version 0.3.3 is the initial public GitHub release; the published tag—not a working-tree hash—is the source identity.

Jalin is Malay for weaving or joining a connection; WP is WordPress. The name, like the Jalin Weave mark, is about interlacing AI clients with a site and store through clear, purposeful joins. It does not imply official WordPress or WooCommerce affiliation, or national endorsement. See the brand guidelines.

What It Does

Area

Capabilities

WordPress

Read and manage posts, pages, categories, tags, existing media metadata, and comments within the account's permissions.

WooCommerce

Manage products, variations and coupons; retrieve orders and customers; create unpaid manual orders and update supported order fields.

Sales And Finance

Analyze sales, tax rates, payment methods, customer fees, shipping, discounts and recorded refunds. Map optional gateway fees, net amounts and affiliate data.

Page Design

Discover templates, use JalinWP Canvas without theme header/footer wrappers, and create structured Gutenberg content with supported core blocks.

Connections

Built-in OAuth registration and WordPress consent for ChatGPT and Claude; an optional local Application Password bridge.

Administration

Separate setup, OAuth connection history, access controls, finance setup, change review and activity screens. Revoke connections and clear inactive history.

New setups use Read Only. Administrators can explicitly select Reviewed Changes, requiring WordPress approval before execution, or YOLO Mode, allowing supported changes without dashboard approval. Native WordPress permissions, current access controls and OAuth consent still apply in every mode.

See the plugin guide for supported operations and boundaries. This version does not collect payments, issue refunds, edit theme PHP, or provide arbitrary code/SQL execution. Structured design adapters cover a bounded set of core blocks; they are not a general visual-builder editor.

Related MCP server: WP Pinch

Requirements

Use

Requirements

WordPress Plugin

WordPress 6.6+, PHP 8.1+, HTTPS and working path-based REST routes. Activate and configure per site; network-wide activation is unsupported.

Commerce Features

An active WooCommerce installation and an account with the relevant WooCommerce permissions.

Package ZIPs

Python 3.9+. No PHP, Node.js or WordPress installation is needed just to package the checked-out source.

Local Integration Tests

Node.js 22+, npm and internet access for the initial pinned dependency/fixture downloads.

The documented local integration environment is WordPress 6.8.8, PHP 8.3 through Playground/SQLite, and WooCommerce 10.2.2 where loaded. Native MariaDB schema checks are recorded separately. That is an executed test environment, not verification of every supported version. See Validation for exact results and pending hosted-client, authenticated-browser and TLS checks.

Build And Install

From the repository root:

python3 scripts/package.py

This creates:

  • dist/jalinwp-0.3.3.zip — installable WordPress plugin.

  • dist/jalinwp-0.3.3-source.zip — complete development source archive.

Upload the installable ZIP through Plugins → Add New → Upload Plugin on staging. The repository archive and GitHub's automatically generated source ZIP are development archives; use the installable ZIP for WordPress.

  1. Activate JalinWP and open Settings → JalinWP → Connection Setup.

  2. Click Enable For My Account. First-time setup remains Read Only; this explicit setup action (or Check Connection) prepares public OAuth metadata when the confirmed web root is writable. Opening the settings page does not write discovery files.

  3. Copy the displayed connector URL into your AI client's custom MCP connection and choose OAuth. Use automatic client registration where supported.

  4. Sign in to WordPress and approve the requested access. Start with a permitted read.

  5. Use Access Controls to enable financial data access or choose another change mode when needed. Additional OAuth permissions require fresh consent.

The connection URL is /wp-json/jalin-mcp/v1/mcp. Install the ZIP as jalin-mcp-gateway/jalin-mcp-gateway.php for a fresh setup.

See Connection Setup and Connection Recovery.

Repository Guide

Location

Purpose

jalin-mcp-gateway/

Installable plugin source, bundled runtime assets, and templates.

scripts/test-runtime/

Disposable WordPress/PHP-WASM runner, pinned npm lockfiles, and integration wrappers.

scripts/

Current repository packaging and verification tools.

docs/

Plugin guides, developer/runtime instructions, and retained historical evidence.

docs/REPOSITORY-SETUP.md

Repository and release preparation notes.

AGENTS.md

Source map and working guidance for coding agents.

CONTRIBUTING.md

Local setup, focused verification and contribution workflow.

SECURITY.md

Vulnerability reporting and security maintenance guidance.

CODE_OF_CONDUCT.md

Contributor Covenant for community spaces.

Historical reports under docs/evidence/ and docs/history/ are sanitized references, not current proofs. See repository kit validation for kit-assembly checks and current validation for executed 0.3.3 results.

Develop And Contribute

Public issues and pull requests are welcome. Begin with Contributing, the Code of Conduct, and the Developer Tests Guide. No access to a live WordPress site is required for the local fixture tests.

Useful implementation references:

License

JalinWP is licensed under GPL-2.0-or-later. See LICENSE. Original implementation for Team Fames. WordPress, WooCommerce and other third-party product names belong to their respective owners; use of those names does not imply endorsement.

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    Not graded
    maintenance
    Enables AI models to interact with WordPress sites through standardized MCP interfaces, supporting content management, post operations, and site configuration with secure JWT authentication and dual transport protocols.
    70 npm
    -
  • A
    license
    Not graded
    quality
    C
    maintenance
    A comprehensive WordPress plugin that implements the Model Context Protocol (MCP) to expose WordPress functionality through standardized interfaces, enabling AI models and applications to interact with WordPress sites securely using multiple transport protocols and enterprise-grade authentication.
    70 npm
    MIT
  • F
    license
    Not graded
    quality
    B
    maintenance
    Enables MCP-compatible AI agents to securely manage multiple self-hosted WordPress sites, including content editing, theme management, and maintenance operations with fine-grained permission controls.
    -