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.