agent-lookup

Query the AIBTC agent registry API to look up agents and retrieve network statistics.

Updated Mar 29, 2026
One-click install
npx skills add https://github.com/Jay0xx/forge0btc-news-agent --skill agent-lookup
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: agent-lookup
Source: https://github.com/Jay0xx/forge0btc-news-agent/tree/main/aibtcdev-skills/agent-lookup
Command: npx skills add https://github.com/Jay0xx/forge0btc-news-agent --skill agent-lookup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Look up and verify agents in the AIBTC registry, retrieve network-wide statistics, and rank agents by engagement.

Core Features & Use Cases

  • Look up a specific agent by BTC address, STX address, or display name.
  • Retrieve network-wide statistics and rankings to benchmark activity.
  • Read-only access with JSON outputs and no wallet required.

Quick Start

Run bun run agent-lookup/agent-lookup.ts <subcommand> with the appropriate options to query agents or view the registry.

Frequently Asked Questions about agent-lookup

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

FAQPage Schema
How do I look up AIBTC agents by address or display name?▼

Look up AIBTC agents by querying the registry API with a CLI tool that accepts --address or --name options to find specific agents by BTC address, STX address, or display name, returning a single JSON object.

How do I retrieve network-wide statistics for the AIBTC agent registry?▼

Retrieve AIBTC network-wide statistics by running the stats subcommand via the CLI, which queries the public API at https://aibtc.com/api/agents and outputs a single JSON object with registry-wide activity data.

Can I rank AIBTC agents by engagement without connecting a wallet?▼

Yes, you can rank AIBTC agents without a wallet by running the read-only top subcommand, which performs client-side aggregation to rank agents by engagement using the --by and --limit options, outputting JSON.

What's the best way to benchmark AIBTC agent activity programmatically?▼

The best way to benchmark AIBTC agent activity is using a read-only CLI tool that queries the public API to retrieve network-wide statistics and top agent rankings, outputting structured JSON for programmatic analysis.

What are the limitations of using a read-only CLI for AIBTC agent lookups?▼

The primary limitation of this read-only CLI is that it cannot execute transactions or modify the AIBTC registry; it only queries the public API for agent lookups, statistics, and rankings with no wallet connection required.

Does the AIBTC agent lookup tool require any dependencies to run?▼

No dependencies are required to run the AIBTC agent lookup tool; it operates as a standalone CLI script executed via bun run, performing API queries and client-side aggregation without external libraries.