AI & Machine Learning
agent4.io
Manage the lifecycle of AI agents, including creation, configuration, and updates.
ENDPOINT 1
https://api.agent4.io/v1/mcp
MCP server metadata
- Name
- agent4-io
Known tools 50
get_agentGet one agent's full configuration (soul/task/tools/skills/knowledge_bases/model/params).
Inferred read-onlyupdate_agentUpdate **part** of an agent — fields you don't pass stay as they are.
Potential side effectslist_mcp_serversList the MCP servers connected in this tenant's tool library (read-only; secret fields omitted).
Inferred read-onlycreate_shareCreate a **share / integration entry point** for an agent — this is how end users actually reach it.
Potential side effectslist_sharesList an agent's shares (token / label / disabled / chat link / embed URL / appearance config).
Inferred read-onlyconfigure_shareConfigure this share — its name and its **appearance** — fields you don't pass stay as they are (server-side partial merge).
Inferred read-onlyset_pwa_brandingConfigure a specific **agent's** PWA branding and install experience (applies to that agent's `/s/` standalone chat pages — what gets installed to the home screen is one agent's entry page, so each agent is its own app).
Inferred read-onlyset_custom_domainBind the client's own domain to this tenant's chat pages: `https://chat.
Inferred read-onlyupdate_skillUpdate part of a skill — fields you don't pass stay as they are (server-side PATCH merge, no GET+PUT round-trip).
Potential side effectstest_skill_triggerReality-check whether your prompts actually trigger tool calls (dry-run) — run this after writing/changing a skill instead of counting corpses in production.
Inferred read-onlylist_knowledge_basesList this tenant's knowledge bases (with doc/chunk counts and relevance cutoff).
Inferred read-onlyget_knowledge_baseGet one knowledge base's configuration (including the full instructions text shown to the model).
Inferred read-onlyupdate_knowledge_baseUpdate part of a knowledge base — fields you don't pass stay as they are (server-side PATCH merge).
Potential side effectsadd_knowledge_textAdd a **text** document to a knowledge base (chunking + embedding happen synchronously; returns the real chunk count).
Inferred read-onlyadd_knowledge_fileAdd a local file's content to a knowledge base (txt/md/html/pdf/docx).
Inferred read-onlysearch_knowledge_baseSearch this knowledge base; returns matching chunks with distances.
Inferred read-onlybuild_knowledge_indexBuild (or rebuild) the structured index for a knowledge base — the second leg beside vector search.
Inferred read-onlyget_knowledge_indexShow the structured index profile: per column coverage, type, numeric range, top values, warnings.
Inferred read-onlypatch_knowledge_indexChange the structured index schema from one sentence of plain language.
Inferred read-onlyimprove_promptRewrite a field's text to work better as an AI system prompt; returns the improved text.
Inferred read-onlydiagnose_promptRead a field and return a list of **specific** improvement suggestions (string array).
Inferred read-onlytest_planner_triggerDry-run the Dynamic Planner's escalation judge: would these messages be offered a step-by-step plan?
Inferred read-onlypreview_planGenerate a plan for a goal and return it for review **without persisting anything** — no temporary storyline, no enrollment, no user affected.
Inferred read-onlytenant_infoThis tenant's basic info and quota (plus custom-domain binding status, if any).
Inferred read-onlylist_end_usersList this tenant's **end users** (the people chatting with your agents) — roster only, never any conversation content.
Inferred read-onlyget_end_userGet one end user's detail: basic profile (name, contact email/phone, city, timezone) + their spaces.
Potential side effectslist_user_sessionsList one end user's **sessions** — metadata only: agent, title (AI summary), message count, tokens, timestamps.
Potential side effectslist_page_contextsList all page playbooks of this tenant (with match rules, greeting mode, position).
Inferred read-onlyresolve_page_contextGiven a URL (or key), show which playbook it resolves to — always verify after writing a match rule.
Inferred read-onlypage_context_statsOpen counts and suggested-question click counts per playbook — find copy nobody clicks.
Inferred read-onlyget_storylineGet one storyline's full definition (whole graph + profile_schema + top-level fields).
Inferred read-onlyupdate_storylineUpdate **part** of a storyline draft — fields you don't pass stay as they are (GET-then-merge on top of a full PUT underneath).
Potential side effectsvalidate_storylineValidate the storyline graph (entry / dead ends / unreachable / dangling / cross-line targets / rule dimensions).
Inferred read-onlypublish_storylinePublish a storyline: validates first (blocking errors → 422), then freezes an immutable version and marks it published.
Potential side effectsunpublish_storylineUnpublish (archive): no more auto-enrolment; in-flight users silently degrade to the plain agent on their next turn (progress kept — re-publishing resumes it).
Inferred read-onlyclone_storylineClone a storyline into a new draft (new key, unpublished, doesn't claim default, no chain pointer) for tweaking.
Inferred read-onlyexport_storylineExport a portable storyline JSON (schema_version + definition; no tenant/version/id) for backup, migration or re-import.
Inferred read-onlyCONNECT WITH APPROVAL
Client installation
Review this server and its permissions before adding it. Secret placeholders must be set locally.
Codex
~/.codex/config.toml
[mcp_servers.agent4-io]
url = "https://api.agent4.io/v1/mcp"
enabled = true
Claude Code
.mcp.json
{
"mcpServers": {
"agent4-io": {
"type": "http",
"url": "https://api.agent4.io/v1/mcp"
}
}
}
Claude Desktop
Settings → Connectors → Add custom connector
Name: agent4-io
Remote MCP URL: https://api.agent4.io/v1/mcp
Add this remote URL as a custom connector in Claude Desktop. Availability depends on the user plan and workspace policy.
Cursor
.cursor/mcp.json
{
"mcpServers": {
"agent4-io": {
"url": "https://api.agent4.io/v1/mcp"
}
}
}
Visual Studio Code
.vscode/mcp.json
Add to Visual Studio Code{
"servers": {
"agent4-io": {
"type": "http",
"url": "https://api.agent4.io/v1/mcp"
}
}
}
Generic MCP
Client-specific MCP configuration
{
"name": "agent4-io",
"transport": "streamable-http",
"url": "https://api.agent4.io/v1/mcp"
}
MCP Inspector
Run the official MCP Inspector locally and enter the indexed Streamable HTTP endpoint.
TRUST AND VERIFICATION EVIDENCE
Trust Data Available
BuiltWith Trust API v2 evidence for agent4.io was fetched 2026-09-04T15:04:22.035Z.
agent4.io is assessed as Trusted: Domain has an established technology history spanning over a year.
Evidence is source-attributed and does not guarantee that a third-party server is safe. Risk labels are conservative metadata heuristics.