agent4.io
Build and run grounded business agents on agent4.io over MCP — agents, knowledge bases, load-on-demand skills, stateful Storylines and page playbooks. Skill: agent4.io Owner: hellojixian Summary: Build and run grounded business agents on agent4.io over MCP — agents, knowledge bases, load-on-demand skills, stateful Storylines and page playbooks. Tags: latest:1.1.11 Version history: v1.1.11 | 2026-08-08T14:20:52.319Z | user Knowledge base routing: a base's description now decides whether a question searches it at all — new Cookbook section on writing one that routes,
Rank
62
Safety
84
Downloads
1.8k
Updated
Oct 10, 2026
Version
1.1.11
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 1.8K downloads reported by the source. Last updated 10/10/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 10, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 10, 2026
- Adoption signal
- 1.8K downloadsadoption · observed Oct 10, 2026
- Latest release
- 1.1.11release · observed Aug 8, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s172sz43hyj8hrb9dmr6bat0gx83kgrd:agent4-io- Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.
- Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-hellojixian-agent4-io/snapshot"
Documentation
CLAWHUB
153,314 characters of source documentation, loaded on request.
Extracted files
3 files captured from the source.
SKILL.md
---
name: agent4-io
description: Build and run grounded business agents on agent4.io over MCP — agents, knowledge bases, load-on-demand skills, stateful Storylines and page playbooks.
homepage: https://agent4.io/cookbook
user-invocable: true
metadata:
{
"openclaw":
{
"emoji": "🤖",
"requires": { "env": ["AGENT4_API_KEY"] },
"primaryEnv": "AGENT4_API_KEY",
"envVars":
[
{
"name": "AGENT4_API_KEY",
"required": true,
"description": "Your agent4.io tenant API key (tk_…). Get it from the agent4.io dashboard → Tenant & API, or console.agent4.io → Settings → Security — the plaintext is shown once, at creation. No account yet? Sign up free at https://agent4.io (5M tokens/month, no card)."
}
]
}
}
---
# agent4.io skills — build agents over MCP
This skill drives the **agent4.io** platform through its remote MCP server: create grounded agents,
knowledge bases, load-on-demand skills, stateful Storylines and page playbooks — all from your agent.
## Connect the MCP server (once)
The tools live on a remote MCP endpoint. Add it to your agent, authenticating with your tenant API key
(set `AGENT4_API_KEY`; get a key from **console → Settings → Security**, shown once at creation):
- **URL:** `https://api.agent4.io/v1/mcp`
- **Header:** `X-API-Key: $AGENT4_API_KEY`
- **Transport:** streamable-http
For Claude Code / any MCP client that takes a shell command:
```bash
claude mcp add --transport http agent4-io https://api.agent4.io/v1/mcp --header "X-API-Key: $AGENT4_API_KEY"
```
Once connected, call `tenant_info()` to confirm you are on the right tenant, then follow the recipes
below. This skill is a mirror of the always-current Cookbook at https://agent4.io/cookbook.
## Use it as a slash command
This skill is invocable directly — `/agent4-io <what you want>` — and routes to the right recipe below:
- `/agent4-io create a support agent grounded in these docs` → build a grounded agent
- `/agent4-io build a knowledge base from this site + these PDFs` → create & populate a KB
- `/agent4-io author a load-on-demand skill for booking` → write a Skill
- `/agent4-io compile this intake flow into a Storyline` → design & publish a Storyline
- `/agent4-io set a page-aware opener for /pricing` → configure a page playbook
- `/agent4-io how much quota have I used?` → usage & quota
- `/agent4-io who are my heaviest users this week?` → look up users and their sessions
- `/agent4-io what is a Storyline?` → look up an agent4.io concept
(On Claude Code and Cursor, the installer also lays down finer-grained shortcuts —
`/agent4-agent`, `/agent4-kb`, `/agent4-skill`, `/agent4-storyline`, `/agent4-docs` — but they all just
hand off to this same skill; here a single `/agent4-io` covers them.)
---
# agent4.io — build agents over MCP
This guide is assembled from the agent4.io Cookbook (https://agent4.io/cookbook). Modules:
- **agent4-io-princip_meta.json
{
"ownerId": "kn715vygmbtxev9229v6dqrc71838kjn",
"slug": "agent4-io",
"version": "1.1.11",
"publishedAt": 1786198852319
}skill-card.md
## Description: Build and run grounded business agents on agent4.io over MCP — agents, knowledge bases, load-on-demand skills, stateful Storylines and page playbooks. This skill is ready for commercial/non-commercial use. ## Publisher: [hellojixian](https://clawhub.ai/user/hellojixian) ### License/Terms of Use: MIT-0 ## Use Case: Developers and tenant operators use this skill to connect an agent to agent4.io, then create and configure agents, knowledge bases, load-on-demand skills, Storylines, page playbooks, usage checks, and related tenant workflows. ### Deployment Geography for Use: Global ## Known Risks and Mitigations: Risk: Tenant configuration, knowledge-base material, and queries may be sent to agent4.io when the skill is used. Mitigation: Tell the user before sending data and send only tenant material they explicitly provide. Risk: The AGENT4_API_KEY grants access to administer the connected agent4.io tenant. Mitigation: Keep the key restricted, avoid exposing it in logs or shared output, and revoke it when no longer needed. Risk: MCP or REST actions can change agents, knowledge bases, Storylines, page playbooks, or other tenant state. Mitigation: Confirm the intended tenant and user intent before state-changing actions, and use tenant_info() to verify the connection. ## Reference(s): - [agent4.io Cookbook](https://agent4.io/cookbook) - [agent4.io](https://agent4.io) - [agent4.io MCP endpoint](https://api.agent4.io/v1/mcp) - [ClawHub skill page](https://clawhub.ai/hellojixian/skills/agent4-io) - [ClawHub publisher profile](https://clawhub.ai/user/hellojixian) ## Skill Output: **Output Type(s):** [Guidance, Shell commands, Configuration, API calls, Markdown, Code] **Output Format:** [Markdown guidance with inline shell, text, JSON, and API examples] **Output Parameters:** [1D] **Other Properties Related to Output:** [Requires AGENT4_API_KEY and may guide state-changing tenant administration actions.] ## Skill Version(s): 1.1.11 (source: server release evidence) ## Ethical Considerations: Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/hellojixian/skills/agent4-io",
"sourceUrl": "https://clawhub.ai/hellojixian/skills/agent4-io",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T01:45:41.177Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-hellojixian-agent4-io/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-hellojixian-agent4-io/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-10T01:45:41.177Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "1.8K downloads",
"href": "https://clawhub.ai/hellojixian/agent4-io",
"sourceUrl": "https://clawhub.ai/hellojixian/agent4-io",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T01:45:41.177Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.1.11",
"href": "https://clawhub.ai/hellojixian/agent4-io",
"sourceUrl": "https://clawhub.ai/hellojixian/agent4-io",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-08-08T14:20:52.319Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-hellojixian-agent4-io/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-hellojixian-agent4-io/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.1.11",
"description": "Knowledge base routing: a base's description now decides whether a question searches it at all — new Cookbook section on writing one that routes, measured against a nine-base tenant.",
"href": "https://clawhub.ai/hellojixian/agent4-io",
"sourceUrl": "https://clawhub.ai/hellojixian/agent4-io",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-08-08T14:20:52.319Z",
"isPublic": true
}
]
}Record generated Oct 10, 2026.
