Agent integration

Connect your agent to Diazites

External AI agents (Hermes, OpenClaw, Cursor, Claude, custom MCP clients) connect to this site over HTTP MCP. Each business uses a bearer token to access only the agents and data you allow.

Get an account Log in to generate a token MCP discovery (GET)

Quick reference

MCP URL
https://www.diazites.com/api/mcp

Auth
Authorization: Bearer diaz_mcp_…

Protocol
JSON-RPC 2.0 · MCP 2024-11-05

Get a token
Dashboard → Agent Manager (after login)

Setup steps

1
Create a Diazites account
Sign up at the site and complete business setup so agents are scoped to your roofing business.
2
Generate an MCP token
Log in → Dashboard → Agent Manager → Generate agent connection token. Choose client type (Hermes, OpenClaw, etc.), agent access, and scopes. Copy the diaz_mcp_… token — it is shown once.
3
Configure your agent
Point your MCP client at the Diazites MCP URL with Authorization: Bearer <token>. Use the examples on this page.
4
Call tools
Use MCP tools/list then tools/call. Tokens only access agents and data you selected when creating the connection.

Scopes

Selected when you create a token. The agent only receives tools for granted scopes.

agents:readRead agent status
agents:writeActivate / deactivate agents
leads:readList leads
leads:writeCreate leads
funnel:readList funnel pages & growth runs
funnel:writeGenerate, publish funnel & run full stack
campaigns:readList campaigns
campaigns:writeCreate campaigns
zernio:readZernio accounts & campaigns (read)
zernio:writeZernio posts (write)
automations:triggerFire automation webhooks

Zernio bridge: optional. Uses the Zernio API key saved under Dashboard → Ads. For full Zernio tooling (280+ tools), connect directly to https://mcp.zernio.com/mcp per Zernio MCP docs.

Tools (Diazites MCP)

Tool	Scope	Description
diazites_agents_status	agents:read	List growth agents (social ads, search, landing page, etc.) and activation status.
diazites_leads_list	leads:read	List recent leads. Optional: limit (max 100).
diazites_leads_create	leads:write	Create a lead. Required: name. Optional: phone, email, roofing_need, notes.
diazites_funnel_run_full	funnel:write (+ agents:write recommended)	Build full funnel: generate 3 landing pages, publish, activate agents, start growth engine from a URL or prompt.
diazites_funnel_generate	funnel:write	Generate 3 AI landing page variants (Dashboard → Funnel parity).
diazites_funnel_list	funnel:read	List landing pages, slugs, and public URLs.
diazites_funnel_publish	funnel:write	Publish a landing page version to /p/{slug}.
diazites_agents_activate	agents:write	Activate growth agents (landing, ads, qualification, etc.).
diazites_campaigns_list	campaigns:read	List campaigns for the business.
diazites_growth_engine_start	funnel:write	Start a growth engine run from a website URL.
zernio_accounts_list	zernio:read + bridge	List Zernio-connected social/ad accounts (requires Zernio bridge + Ads API key).
zernio_campaigns_list	zernio:read + bridge	List Zernio ad campaigns for the business.
zernio_posts_create	zernio:write + bridge	Cross-post via Zernio. Required: content, platforms (JSON array).

JSON-RPC examples

initialize

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2024-11-05",
    "capabilities": {},
    "clientInfo": {
      "name": "hermes",
      "version": "1.0.0"
    }
  }
}

tools/list

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/list"
}

tools/call (list leads)

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "diazites_leads_list",
    "arguments": {
      "limit": 10
    }
  }
}

Client configuration

Hermes Agent (~/.hermes/config.yaml)

mcp_servers:
  diazites:
    url: "https://www.diazites.com/api/mcp"
    headers:
      Authorization: "Bearer YOUR_DIAZ_MCP_TOKEN"
    timeout: 120
    enabled: true

Cursor (.cursor/mcp.json)

{
  "diazites": {
    "type": "http",
    "url": "https://www.diazites.com/api/mcp",
    "headers": {
      "Authorization": "Bearer YOUR_DIAZ_MCP_TOKEN"
    }
  }
}

Raw HTTP (curl)

POST https://www.diazites.com/api/mcp
Authorization: Bearer YOUR_DIAZ_MCP_TOKEN
Content-Type: application/json

{"jsonrpc":"2.0","id":1,"method":"tools/list"}

Errors

401 — missing or invalid diaz_mcp_ token (revoked or wrong value).
Tool not listed — token missing scope or agent not in allowed_agent_types.
Zernio bridge errors — connect Zernio on Dashboard → Ads or use Zernio MCP directly.

Logged in?

Generate and manage tokens in the dashboard — includes copy-paste config and connection list.

Open Agent Manager