Read Tools

lookup_agent(query)

Look up an agent by owner wallet address or PDA.

verify_agent(owner, minTier?, minReputation?)

Verify that an agent meets minimum tier and reputation requirements.

list_agents(tier?, status?, category?, minReputation?, limit?)

Search and filter agents by various criteria.

Parameter constraints: tier accepts ["observer", "basic", "standard", "premium"]; status accepts ["active", "suspended", "deactivated"]; minReputation range is 0–1000; limit max 50 (default 20).

Note: Agents with card hash mismatches are excluded from results by default.

check_reputation(owner)

Get an agent's current reputation score and recent history.

resolve_did(did)

Resolve a did:sol identifier to a W3C DID Document.

check_credentials(owner, type?, activeOnly?)

Get an agent's Verifiable Credentials, optionally filtered by type.

Example Returns

lookup_agent

Response 
{
  "did": "did:sol:7xKXtg2CW87d97TXJSDpHD4vMvnQ1985FchZRgCd9oPr",
  "name": "CommerceBot",
  "owner": "7xKXtg2CW87d97TXJSDpHD4vMvnQ1985FchZRgCd9oPr",
  "pda": "BKq8rN4EwJQG3R9FnLhSGqJ2tNkh8cVRxvNApj7hbfQM",
  "tier": "standard",
  "status": "active",
  "reputationScore": 720,
  "capabilities": 15,
  "serviceCategory": "commerce",
  "version": "1.0.0",
  "agentCardUrl": "https://commercebot.example/.well-known/agent.json",
  "createdAt": "2026-03-01T10:00:00.000Z",
  "updatedAt": "2026-03-15T14:30:00.000Z"
}

verify_agent

Response 
{
  "verified": true,
  "agent": "CommerceBot",
  "did": "did:sol:7xKXtg2CW87d97TXJSDpHD4vMvnQ1985FchZRgCd9oPr",
  "checks": [
    { "check": "active", "passed": true, "detail": "Agent is active" },
    { "check": "tier", "passed": true, "detail": "Agent tier standard meets minimum basic" },
    { "check": "reputation", "passed": true, "detail": "Reputation 720 meets minimum 500" }
  ]
}

list_agents

Response 
{
  "total": 3,
  "agents": [
    {
      "did": "did:sol:7xKXtg2CW87d97TXJSDpHD4vMvnQ1985FchZRgCd9oPr",
      "name": "CommerceBot",
      "tier": "standard",
      "reputationScore": 720,
      "serviceCategory": "commerce",
      "status": "active"
    }
  ]
}

check_reputation

Response 
{
  "did": "did:sol:7xKXtg2CW87d97TXJSDpHD4vMvnQ1985FchZRgCd9oPr",
  "name": "CommerceBot",
  "reputationScore": 720,
  "tier": "standard",
  "status": "active",
  "recentHistory": [
    { "old_value": "700", "new_value": "720", "delta": "+20", "timestamp": "2026-03-15T14:30:00.000Z" },
    { "old_value": "680", "new_value": "700", "delta": "+20", "timestamp": "2026-03-12T09:15:00.000Z" }
  ]
}

resolve_did

Response 
{
  "did": "did:sol:7xKXtg2CW87d97TXJSDpHD4vMvnQ1985FchZRgCd9oPr",
  "didDocument": {
    "@context": ["https://www.w3.org/ns/did/v1", "https://w3id.org/security/suites/ed25519-2020/v1"],
    "id": "did:sol:7xKXtg2CW87d97TXJSDpHD4vMvnQ1985FchZRgCd9oPr",
    "controller": "did:sol:7xKXtg2CW87d97TXJSDpHD4vMvnQ1985FchZRgCd9oPr",
    "verificationMethod": [{
      "id": "did:sol:7xKXtg2CW87d97TXJSDpHD4vMvnQ1985FchZRgCd9oPr#key-1",
      "type": "Ed25519VerificationKey2020",
      "controller": "did:sol:7xKXtg2CW87d97TXJSDpHD4vMvnQ1985FchZRgCd9oPr",
      "publicKeyBase58": "7xKXtg2CW87d97TXJSDpHD4vMvnQ1985FchZRgCd9oPr"
    }],
    "authentication": ["did:sol:7xKXtg2CW87d97TXJSDpHD4vMvnQ1985FchZRgCd9oPr#key-1"],
    "assertionMethod": ["did:sol:7xKXtg2CW87d97TXJSDpHD4vMvnQ1985FchZRgCd9oPr#key-1"],
    "service": [
      { "id": "did:sol:7xKXtg2CW87d97TXJSDpHD4vMvnQ1985FchZRgCd9oPr#agent-card", "type": "A2AAgentCard", "description": "A2A Agent Card for capability discovery", "serviceEndpoint": "https://commercebot.example/.well-known/agent.json" },
      { "id": "did:sol:7xKXtg2CW87d97TXJSDpHD4vMvnQ1985FchZRgCd9oPr#vouch-registry", "type": "VouchRegistry", "description": "On-chain Vouch identity PDA", "serviceEndpoint": "solana:5i73FN7Ycgnh9dr2Yzf3oFiTCKhu85JPpTUbZ84VPtu4:BKq8rN4EwJQG3R9FnLhSGqJ2tNkh8cVRxvNApj7hbfQM" }
    ]
  },
  "agent": {
    "name": "CommerceBot",
    "tier": "standard",
    "status": "active",
    "reputationScore": 720,
    "agentCardUrl": "https://commercebot.example/.well-known/agent.json"
  }
}

check_credentials

Response 
{
  "did": "did:sol:7xKXtg2CW87d97TXJSDpHD4vMvnQ1985FchZRgCd9oPr",
  "agent": "CommerceBot",
  "totalCredentials": 1,
  "credentials": [
    {
      "type": "SecurityAuditCredential",
      "issuer": "did:sol:AuditorPubkey123...",
      "credentialUrl": "https://auditor.example/vc/123.json",
      "validFrom": "2026-01-01T00:00:00Z",
      "validUntil": "2027-01-01T00:00:00Z",
      "structurallyValid": true
    }
  ]
}