MCP-Server

Kawal

io.github.PugarHuda/kawal
KI & Agenten Suche & Recherche Öffentlich und erreichbar MCP 2026-07-28

Was dieses MCP kann

Discovers and live-verifies ERC-8004 agents on BNB Smart Chain, checking endpoints, payment behavior, uptime, reputation, and historical probe evidence.

agents_by_owner
Every agent an address minted, called now
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.
Nur Lesen Externer Zugriff Idempotent
Eingabeschema
{'type': 'object', 'required': ['owner'], '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.'}}}
check_payment
Ask whether an agent really charges
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.
Nur Lesen Externer Zugriff Idempotent
Eingabeschema
{'type': 'object', 'required': ['tokenId'], 'properties': {'chainId': {'type': 'number', 'description': 'Chain id. One of 56, 97. Defaults to 56.'}, 'tokenId': {'type': 'string', 'description': 'ERC-8004 token id, decimal digits.'}}}
compare_agents
The same questions of two or three 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.
Nur Lesen Externer Zugriff Idempotent
Eingabeschema
{'type': 'object', 'required': ['agents'], 'properties': {'agents': {'type': 'array', 'items': {'type': 'object', 'required': ['tokenId'], 'properties': {'chainId': {'type': 'number', 'description': 'Chain id. One of 56, 97. Defaults to 56.'}, 'tokenId': {'type': 'string', 'description': 'ERC-8004 token id, decimal digits.'}}}, 'maxItems': 3, 'minItems': 1, 'description': 'One to 3 agents to compare.'}}}
deep_report
Everything Kawal holds about one agent (paid)
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.
Externer Zugriff
Eingabeschema
{'type': 'object', 'required': ['tokenId'], 'properties': {'txHash': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{64}$', 'description': 'Hash of the BNB transfer that paid the terms: 0x followed by 64 hex characters. Omit to receive the terms.'}, 'chainId': {'type': 'number', 'description': 'Chain id. One of 56, 97. Defaults to 56.'}, 'tokenId': {'type': 'string', 'description': 'ERC-8004 token id, decimal digits.'}}}
find_agents
Search the roster by problem
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.
Nur Lesen Externer Zugriff Idempotent
Eingabeschema
{'type': 'object', 'properties': {'limit': {'type': 'number', 'description': 'How many to return, at most 20.'}, '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.'}, 'chainId': {'type': 'number', 'description': 'Chain id. One of 56, 97. Defaults to 56.'}, 'trending': {'enum': ['24h', '7d', '30d'], 'type': 'string', 'description': "Return 8004scan's trending agents for this window instead of a search, in the registry's order."}}}
plan_mandate
Plan four bounded seats for a capital amount
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.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', 'required': ['capitalUsdt', 'days'], 'properties': {'days': {'type': 'integer', 'maximum': 365, 'minimum': 1, 'description': 'How long the mandate runs, in whole days. 1 to 365.'}, 'chainId': {'type': 'number', 'description': 'Chain id. One of 56, 97. Defaults to 56.'}, 'capitalUsdt': {'type': 'number', 'maximum': 1000000000000, 'description': 'Capital to entrust, in USDT. Positive, at most 1000000000000.', 'exclusiveMinimum': 0}}}
read_reputation
Who wrote an agent's feedback
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.
Nur Lesen Externer Zugriff Idempotent
Eingabeschema
{'type': 'object', 'required': ['tokenId'], 'properties': {'chainId': {'type': 'number', 'description': 'Chain id. One of 56, 97. Defaults to 56.'}, 'tokenId': {'type': 'string', 'description': 'ERC-8004 token id, decimal digits.'}}}
uptime_history
Every probe Kawal has made of an agent
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.
Nur Lesen Externer Zugriff Idempotent
Eingabeschema
{'type': 'object', 'required': ['tokenId'], 'properties': {'chainId': {'type': 'number', 'description': 'Chain id. One of 56, 97. Defaults to 56.'}, 'tokenId': {'type': 'string', 'description': 'ERC-8004 token id, decimal digits.'}}}
verify_agent
Verify an agent by calling it
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.
Nur Lesen Externer Zugriff Idempotent
Eingabeschema
{'type': 'object', 'required': ['tokenId'], 'properties': {'chainId': {'type': 'number', 'description': 'Chain id. One of 56, 97. Defaults to 56.'}, 'tokenId': {'type': 'string', 'description': 'ERC-8004 token id, decimal digits.'}}}
Hinzugefügt
deep_report
17. September 2026 12:49
Hinzugefügt
plan_mandate
17. September 2026 12:49
Hinzugefügt
uptime_history
17. September 2026 12:49
Hinzugefügt
compare_agents
17. September 2026 12:49
Hinzugefügt
agents_by_owner
17. September 2026 12:49
Hinzugefügt
find_agents
17. September 2026 12:49
Hinzugefügt
read_reputation
17. September 2026 12:49
Hinzugefügt
check_payment
17. September 2026 12:49
Hinzugefügt
verify_agent
17. September 2026 12:49