query-credentials

Query agent identities, credentials, and verification status via on-chain lookups and REST APIs.

3|2|Updated Feb 18, 2026
One-click install
npx skills add https://github.com/selfxyz/self-agent-id --skill query-credentials
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: query-credentials
Source: https://github.com/selfxyz/self-agent-id/tree/main/plugin/skills/query-credentials
Command: npx skills add https://github.com/selfxyz/self-agent-id --skill query-credentials

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill allows you to programmatically look up and verify the human identity and credentials of AI agents, ensuring trust and compliance in your interactions.

Core Features & Use Cases

  • Agent Lookup: Retrieve detailed information about any registered agent, including their verification status, credentials, and reputation score.
  • Human Agent Discovery: List all agents registered by a specific human wallet address.
  • Self Identity Check: Query your own agent's registered identity and credentials.
  • Use Case: Before allowing an unknown agent to access a sensitive API, use this Skill to check its is_verified status and ofacClean credential to ensure it meets your security and compliance requirements.

Quick Start

Look up the agent with ID 5 on the mainnet and retrieve its full information.

Frequently Asked Questions about query-credentials

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I verify an AI agent's identity and credentials on-chain?

To verify an AI agent's identity, you can query on-chain data and REST APIs to retrieve its verification status, ZK-attested credentials, and reputation score. This provides read-only access to Self Agent ID data for ensuring trust and compliance in agent interactions.

What's the best way to check if an AI agent is OFAC compliant before granting API access?

The best way to check an AI agent's OFAC compliance is to query its `ofacClean` credential and `is_verified` status via a read-only on-chain lookup. This ensures the agent meets your security and compliance requirements before API access.

How do I discover all AI agents registered by a specific human wallet address?

To discover all AI agents registered by a specific human wallet address, you can perform an on-chain lookup via REST API. This returns a list of all agents associated with that specific human address.

Do I need a private key to query an AI agent's public verification status?

No, you do not need a private key to query an AI agent's public verification status, credentials, or reputation score. A private key (`SELF_AGENT_PRIVATE_KEY`) is only required for the `self_get_identity` function to check your own agent's identity.

Can I retrieve the freshness status and reputation score of a registered AI agent?

Yes, you can retrieve the freshness status and reputation score of a registered AI agent through on-chain lookups. This data is part of the detailed agent information available via the REST API.

How does ZK proof work for AI agent credential verification?

ZK-attested credentials are retrieved via on-chain lookups to verify an AI agent's identity without exposing underlying private data. This mechanism ensures that the agent's credentials are cryptographically proven and trustworthy.