Kawal

Official9 tools

by PugarHuda

Evidence about ERC-8004 agents on BNB Smart Chain, gathered by calling them. No key.

io.github.PugarHuda/kawal (MCP Server)

This MCP server provides evidence about ERC-8004 agents on BNB Smart Chain, gathered by calling them. The server is identified as io.github.PugarHuda/kawal and is available under the slug io-github-pugarhuda-kawal. It exposes 9 tools for retrieving the gathered evidence. No key is included.

🛠️ Key Features

Evidence collection about ERC-8004 agents on BNB Smart Chain
Tooling available: 9 tools
Data gathered by calling ERC-8004 agents
No key

🚀 Use Cases

Inspect or retrieve evidence related to ERC-8004 agents on BNB Smart Chain

⚡ Developer Benefits

9 callable tools to access evidence gathered from ERC-8004 agents

⚠️ Limitations

Description does not specify supported functions, schemas, or response formats beyond “evidence gathered by calling them”

Captured live from the server via tools/list.

verify_agent

Call an agent's declared endpoint right now and report what answered. This is a live handshake made by Kawal, not a reading of the registry: an agent whose registration declares MCP but whose endpoint is gone is reported as not answering. Returns the hireability tier and the evidence behind it, including how many times Kawal has reached this endpoint before.

Parameters2

chainId	number	optional	Chain id. One of 56, 97. Defaults to 56.
tokenId	string	required	ERC-8004 token id, decimal digits.

Raw schema

{
  "type": "object",
  "properties": {
    "chainId": {
      "type": "number",
      "description": "Chain id. One of 56, 97. Defaults to 56."
    },
    "tokenId": {
      "type": "string",
      "description": "ERC-8004 token id, decimal digits."
    }
  },
  "required": [
    "tokenId"
  ]
}

check_payment

Send the opening request of the x402 protocol — no payment header — and report whether the server actually demands payment. `x402_supported` on the registry is a flag a registration sets about itself; this is the answer to asking. Kawal never settles a payment, so the price is quoted in the server's own words and nothing moves.

Parameters2

chainId	number	optional	Chain id. One of 56, 97. Defaults to 56.
tokenId	string	required	ERC-8004 token id, decimal digits.

Raw schema

{
  "type": "object",
  "properties": {
    "chainId": {
      "type": "number",
      "description": "Chain id. One of 56, 97. Defaults to 56."
    },
    "tokenId": {
      "type": "string",
      "description": "ERC-8004 token id, decimal digits."
    }
  },
  "required": [
    "tokenId"
  ]
}

read_reputation

Report who wrote an agent's ERC-8004 feedback, not how much of it there is. A sample of 1,200 BSC records came from 53 addresses, one of which wrote 265 of the oldest 600, so a count of records is a count of writes rather than of opinions. Returns how many carry a mark, how many distinct addresses wrote them, and what share came from the busiest one.

Parameters2

chainId	number	optional	Chain id. One of 56, 97. Defaults to 56.
tokenId	string	required	ERC-8004 token id, decimal digits.

Raw schema

{
  "type": "object",
  "properties": {
    "chainId": {
      "type": "number",
      "description": "Chain id. One of 56, 97. Defaults to 56."
    },
    "tokenId": {
      "type": "string",
      "description": "ERC-8004 token id, decimal digits."
    }
  },
  "required": [
    "tokenId"
  ]
}

find_agents

Search the BSC roster by describing the problem rather than naming a product, and get back agents ranked with Kawal's evidence attached. Duplicate registrations are collapsed: roughly two thirds of the newest registrations are copies of a template, and returning all of them would be returning the same agent many times. With `trending`, the list is instead what 8004scan's visitors looked at most over that window — attention, not evidence — each entry carrying the tier Kawal's own record gives it, which is where the two disagree.

Parameters4

query	string	optional	What you need done, in plain words. Optional when `trending` is given; then it filters the trending list by name or description.
trending	string	optional	Return 8004scan's trending agents for this window instead of a search, in the registry's order.
limit	number	optional	How many to return, at most 20.
chainId	number	optional	Chain id. One of 56, 97. Defaults to 56.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "What you need done, in plain words. Optional when `trending` is given; then it filters the trending list by name or description."
    },
    "trending": {
      "type": "string",
      "enum": [
        "24h",
        "7d",
        "30d"
      ],
      "description": "Return 8004scan's trending agents for this window instead of a search, in the registry's order."
    },
    "limit": {
      "type": "number",
      "description": "How many to return, at most 20."
    },
    "chainId": {
      "type": "number",
      "description": "Chain id. One of 56, 97. Defaults to 56."
    }
  }
}

agents_by_owner

List the agents one wallet registered on BSC and call each of their declared endpoints now. Nothing on the chain tells an owner their endpoint went dark — the registry keeps listing it — so this is the answer to "is my agent still answering?": what answered, how each failure looks, and every probe Kawal kept. At most 12 agents are dialled, so a large owner sees the first page.

Parameters2

owner	string	required	The wallet that minted the registrations: 0x followed by forty hex characters. `address` is accepted as an alias.
chainId	number	optional	Chain id. One of 56, 97. Defaults to 56.

Raw schema

{
  "type": "object",
  "properties": {
    "owner": {
      "type": "string",
      "description": "The wallet that minted the registrations: 0x followed by forty hex characters. `address` is accepted as an alias."
    },
    "chainId": {
      "type": "number",
      "description": "Chain id. One of 56, 97. Defaults to 56."
    }
  },
  "required": [
    "owner"
  ]
}

compare_agents

Put two or three agents side by side and answer the same questions of each — the ones a buyer weighs before handing over a spend cap: can it be hired, does it answer right now, has it kept answering, what does it offer, what does it say it costs, does its domain verify, what is its track record, what is flagged against it, and when it was registered. Each agent is dialled for this call. No combined score: the disagreements are the point.

Parameters1

agents

array

required

One to 3 agents to compare.

Raw schema

{
  "type": "object",
  "properties": {
    "agents": {
      "type": "array",
      "description": "One to 3 agents to compare.",
      "minItems": 1,
      "maxItems": 3,
      "items": {
        "type": "object",
        "properties": {
          "chainId": {
            "type": "number",
            "description": "Chain id. One of 56, 97. Defaults to 56."
          },
          "tokenId": {
            "type": "string",
            "description": "ERC-8004 token id, decimal digits."
          }
        },
        "required": [
          "tokenId"
        ]
      }
    }
  },
  "required": [
    "agents"
  ]
}

uptime_history

Read the history Kawal keeps of one agent's endpoint without dialling it: how many times it was called, how many times it answered in the protocol it declared, since when, and the median and worst latency of the answering calls. This is the record the registry does not have. Null when Kawal has never called this endpoint; verify_agent makes the first call.

Parameters2

chainId	number	optional	Chain id. One of 56, 97. Defaults to 56.
tokenId	string	required	ERC-8004 token id, decimal digits.

Raw schema

{
  "type": "object",
  "properties": {
    "chainId": {
      "type": "number",
      "description": "Chain id. One of 56, 97. Defaults to 56."
    },
    "tokenId": {
      "type": "string",
      "description": "ERC-8004 token id, decimal digits."
    }
  },
  "required": [
    "tokenId"
  ]
}

plan_mandate

Turn a capital amount and a duration into the four scoped sessions Kawal would grant on Altana — one per seat, each with its own contract allowlist, spend cap and expiry — without granting anything. Pure arithmetic over the venue table: the same plan the mandate form shows, and the same refusals, since a plan that would widen authority (an unproven venue, an empty allowlist, caps that overcommit) is refused rather than built.

Parameters3

capitalUsdt	number	required	Capital to entrust, in USDT. Positive, at most 1000000000000.
days	integer	required	How long the mandate runs, in whole days. 1 to 365.
chainId	number	optional	Chain id. One of 56, 97. Defaults to 56.

Raw schema

{
  "type": "object",
  "properties": {
    "capitalUsdt": {
      "type": "number",
      "description": "Capital to entrust, in USDT. Positive, at most 1000000000000.",
      "exclusiveMinimum": 0,
      "maximum": 1000000000000
    },
    "days": {
      "type": "integer",
      "description": "How long the mandate runs, in whole days. 1 to 365.",
      "minimum": 1,
      "maximum": 365
    },
    "chainId": {
      "type": "number",
      "description": "Chain id. One of 56, 97. Defaults to 56."
    }
  },
  "required": [
    "capitalUsdt",
    "days"
  ]
}

deep_report

Everything Kawal holds about one agent in a single answer: the live handshake, the full probe history, how the endpoint fails when it fails, whether it really charges, and who wrote its feedback. This one costs money. Kawal measured that 75 of 200 BSC registrations declare x402 support and that none of the reachable ones ever asks to be paid; this is the counter-example. Calling it without payment returns the terms rather than the report. Pay the terms with a plain BNB transfer and call again with `txHash`; the receipt is read on-chain and spent once.

Parameters3

chainId	number	optional	Chain id. One of 56, 97. Defaults to 56.
tokenId	string	required	ERC-8004 token id, decimal digits.
txHash	string	optional	Hash of the BNB transfer that paid the terms: 0x followed by 64 hex characters. Omit to receive the terms.

Raw schema

{
  "type": "object",
  "properties": {
    "chainId": {
      "type": "number",
      "description": "Chain id. One of 56, 97. Defaults to 56."
    },
    "tokenId": {
      "type": "string",
      "description": "ERC-8004 token id, decimal digits."
    },
    "txHash": {
      "type": "string",
      "description": "Hash of the BNB transfer that paid the terms: 0x followed by 64 hex characters. Omit to receive the terms.",
      "pattern": "^0x[0-9a-fA-F]{64}$"
    }
  },
  "required": [
    "tokenId"
  ]
}

Install

Tools (9)

verify_agentcheck_paymentread_reputationfind_agentsagents_by_ownercompare_agentsuptime_historyplan_mandate

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://kawal-three.vercel.app/api/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "kawal": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://kawal-three.vercel.app/api/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

io.github.PugarHuda/kawal (MCP Server)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

verify_agent

check_payment

read_reputation

find_agents

agents_by_owner

compare_agents

uptime_history

plan_mandate

deep_report

Install

Remote endpoint

Related servers