ECZ-ID Agent Trust
Find agent surfaces and missing public proof references locally.
Free, local-first. No source upload. No sign-in to run a check.
- Detects agent manifests, frameworks, MCP tool configs, tool/action specs and webhooks.
- Plain-English posture — never a “acceptable” or “unacceptable” verdict.
- Validate or scaffold
ecz-agent.json locally, only when you ask.
Useful for
Useful across many legitimate roles. Commonly used by:
- AI-agent and MCP tool builders
- Platform and AppSec teams integrating agents
- Enterprise architects reviewing agent posture
- Reviewers and architects evaluating third-party agents
Relevant when you are wiring an agent or MCP tool, before granting an agent tool access, an evaluator asks for agent provenance, you are reviewing a third-party agent.
What you can do in under a minute
- Open or scan the workspace — run
ECZ-ID Agent Trust: Scan Workspace.
- Review findings in plain English — grouped, with neutral posture.
- Open Resolver guidance or continue supported setup where relevant.
What it looks for
- Agent manifests (
agent.yaml, agent.json) and tool / action specs.
- Agent frameworks (LangChain/LangGraph, CrewAI, AutoGen, Semantic Kernel, LlamaIndex, OpenAI, Anthropic).
- MCP tool configuration and webhooks an agent may call.
- Whether an
ecz-agent.json / .well-known/ecz-agent.json resolver reference is present.
Example result
ECZ-ID Agent Trust - 2 agent surfaces
- agent.yaml ........... no ecz-agent.json reference found yet
- mcp tool config ...... resolver reference present
Posture: neutral - local policy decides, re-check before reliance
What results mean
Results describe public-proof posture, never a safety, approval, certification or compliance verdict:
resolvable · partial public proof · no public proof reference found yet · review recommended · re-check before reliance · your local policy decides.
There is no “pass/fail”. Local policy decides what is sufficient, and you should re-check before reliance.
Recommended next steps
- Inspect the finding — plain-English detail, no verdict.
- Copy verification guidance — a claim-free snippet you can share.
- Open Resolver — read-only public proof lookup.
- Continue supported setup — hand off to TrustOps (metadata only).
- Open documentation — Developer Gateway.
- Re-check later — re-run before you rely on a result.
Privacy & permissions
| Question |
Answer |
| Files read |
Filenames and paths during a normal scan |
| File contents read |
No — except a file you explicitly target (e.g. an ecz-*.json you ask to validate) |
| Selected text read |
No |
| Anything uploaded |
No source, prompts, secrets or tool payloads leave your device |
| Network destinations |
Only the links you click (Resolver / TrustOps / Developer Gateway) open in your browser |
| Telemetry |
None |
| Retention |
None — no caller data is stored or persisted |
| Local storage |
Minimal extension state only |
| Workspace Trust |
Respected; scanning is gated by VS Code Workspace Trust |
See the bundled PRIVACY.md for the full notice.
Frequently asked questions
Is this extension free?
Yes. Every local check is free — you never need to sign in or pay to run one.
Does it upload my source code?
No. No source, prompts, secrets or tool payloads ever leave your device, and there is no telemetry.
Does it read my file contents?
It reads filenames and paths during a scan. It only reads the contents of a file you explicitly ask it to inspect (for example an ecz-*.json you choose to validate).
Does a missing proof reference mean something is unsafe?
No. “No public proof reference found yet” is neutral — it is not a verdict of “unsafe”. It only means resolver-verifiable public proof was not detected.
What does Resolver do?
Resolver is a read-only public proof lookup. The extension can open it so you can check public proof yourself; the extension never writes, activates or decides anything.
Do I need an ECZ-ID before using the extension?
No. You can run every local check without one. An ECZ-ID is only relevant if you later choose supported setup in TrustOps.
What happens when I continue supported setup?
The extension hands off to TrustOps with metadata only. It runs no checkout itself; TrustOps handles acquisition, setup and lifecycle.
Can this extension make a compliance or approval decision?
No. It surfaces posture and routes you to proof. Local policy decides sufficiency; it never certifies, approves or guarantees.
Which agent frameworks can it detect?
Common agent manifests and frameworks — LangChain/LangGraph, CrewAI, AutoGen, Semantic Kernel, LlamaIndex — plus tool/action specs and MCP tool configurations.
What does the manifest scaffold command change?
Only ecz-agent.json, and only when you invoke it. It reads and writes that single local file; nothing else is touched.
Does it run or call my agents?
No. It inspects local files only. It never executes an agent, tool or webhook.
What it does not do
- No source / prompt / secret upload, and no telemetry.
- Provides local evidence review and guidance only - it does not issue ECZ-ID proof, activate services, grant access, or make approval, safety, insurance or compliance decisions.
- Makes no safety, approval, certification or compliance claim. Does not imply that any agent is acceptable or unacceptable. The optional scaffold/validate command reads only
ecz-agent.json, and only when you invoke it.
- Runs no checkout or payment — commercial actions happen only in TrustOps.
Install & first use
- In your editor's Extensions view, search for ECZ-ID Agent Trust (publisher EcoCitizenz) and install it.
- Open a project and trust the workspace.
- Run
ECZ-ID Agent Trust: Scan Workspace and review the grouped findings.
Free vs supported setup
- Free, local-first: detected agent surfaces with neutral posture, missing-public-proof findings, and Resolver / supported-setup routes — no sign-in and no purchase to run a check.
- Supported setup (TrustOps): maintained ECZ-ID identity, public proof and lifecycle for agent identity and public proof — relevant when you need a resolver-verifiable result others can check, not just local review.
- You never need to buy anything to get local value; supported setup is a separate, optional step handled entirely in TrustOps.
Python / CLI
Prefer Python, CI or terminal automation?
python -m pip install ecz-id-agents
ecz-id-agents --help
The Python tools run locally and inspect, explain and route only — the same role boundary as this extension. They do not issue an ECZ-ID, create public proof or replace Resolver proof.
Machine-readable facts
| Field |
Value |
| Product |
ECZ-ID Agent Trust |
| Identity |
ecocitizenz.eczid-ai-agents |
| Publisher |
EcoCitizenz |
| License |
Free; see the bundled LICENSE.txt |
| Version |
0.1.3 |
| Page family |
functional-extension |
| Purpose |
Resolve the agent before you allow it to act. |
| Applicable audiences |
AI-agent and MCP tool builders; Platform and AppSec teams integrating agents; Enterprise architects reviewing agent posture; Reviewers and architects evaluating third-party agents |
| Applicable scenarios |
you are wiring an agent or MCP tool; before granting an agent tool access; an evaluator asks for agent provenance; you are reviewing a third-party agent |
| Primary command |
ECZ-ID Agent Trust: Scan Workspace |
| Inputs |
Agent manifests (agent.yaml / agent.json), framework configs, MCP tool configs, webhooks, ecz-agent.json |
| Outputs |
Detected agent surfaces with neutral posture, missing-public-proof findings, and Resolver / supported-setup routes |
| Data handling |
Filenames and paths only; no source / prompt / secret upload; no telemetry; retention none |
| Network behaviour |
Only the links you open (Resolver / TrustOps / Developer Gateway); no background network call |
| Result states |
evidence observed; evidence not observed; no public proof reference found yet; review recommended; re-check before reliance; local policy decides |
| Limitations |
Does not issue proof, approve, certify, insure, underwrite, determine compliance, or run checkout |
| Canonical machine discovery |
https://machine.ecocitizenz.org/.well-known/ecz-machine.json |
| Public proof |
https://resolver.ecocitizenz.org |
| Documentation |
https://developers.ecocitizenz.com |
| Supported setup |
https://trustops.ecocitizenz.com/start |
| Re-check |
Re-run before reliance |
Need help choosing the right ECZ-ID route?
Use ECZ-ID GPT guidance: https://trustops.ecocitizenz.com/start#gpt-guidance
Route guidance only. TrustOps handles setup; Backend/Core writes truth; Resolver proves public state. Local policy decides reliance. Re-check before reliance.
Links & support
ECZ-ID is independent trust infrastructure. Third-party names describe compatible ecosystems only and do not imply endorsement or affiliation. Local policy decides whether the evidence you review is sufficient.