WebMCP Embed Script
Drop a single <script> tag into your website so visitors' AI assistants can evaluate your deployed rules directly in the browser, via WebMCP.
Audience: Web developers who want their site to serve its own rules Prerequisites: A deployment (Exporting Rules for Deployment) and the ability to edit your site's HTML Time: 5 minutes Goal: Embed the WebMCP loader and expose your rules to on-page assistants
When to Use This
Use the WebMCP embed when you want your website itself to offer your rules as tools — e.g. an eligibility checker or a contract clause evaluator that a visitor's browser-side AI agent can call without any backend integration on their part. The script registers your deployment's rules as WebMCP tools scoped to the page.
For server-side or agent integrations, use the MCP server or OpenAPI spec instead.
The Script
Legalese Cloud:
<script
src="https://api.legalese.cloud/.webmcp/embed.js"
data-org="{orgSlug}"
data-scope="*"
data-tools="auto"
data-api-key="sk_..."
></script>
Self-hosted jl4-service:
<script
src="http://{serviceUrl}/.webmcp/embed.js"
data-scope="*"
data-tools="auto"
data-api-key="sk_..."
></script>
The VS Code Integrate dialog pre-fills the correct src for your connection.
Attributes
| Attribute | Meaning |
|---|---|
src |
The WebMCP loader served by Legalese Cloud / your jl4-service |
data-org |
Your organization slug on Legalese Cloud. Unnecessary for jl4-service |
data-scope |
Which pages the tools are offered on (* = the whole site) |
data-tools |
auto registers every exported rule; or a comma-separated allow-list |
data-api-key |
A Legalese Cloud API key authorizing rule evaluation |
Getting an API Key
Replace sk_... with a real key:
- Open the Legalese Cloud console.
- Create an API key scoped to the deployment (or organization) you are embedding and with
l4:rulesandl4:evaluatepermissions. - Paste your organization slug into
data-organd your API key intodata-api-key.
Legalese Cloud Permissions
| Permission | Enables |
|---|---|
l4:rules |
The embed script registers each exported rule as a WebMCP tool the visitor's on-page agent can see. |
l4:evaluate |
The agent can actually run a rule and get its decision back. |
Deliberately omit l4:read here: the browser only needs to discover and call the rules, not download their full source/schema. And because the key ships in client-side HTML, scope it to rule evaluation only, restrict it to this deployment, and rotate it if exposed. Treat it like a publishable key, not a secret.
Verify
Load a page that includes the script and open a WebMCP-aware assistant. Your exported rules appear as available tools; invoking one runs the deployed rule and returns its typed decision.
Notes
data-tools="auto"keeps the tool list in sync with redeploys.- A self-hosted
jl4-serviceserves the loader athttp://{serviceUrl}/.webmcp/embed.js.