check_handle
Check if a desired handle is available for agent registration on A2A Market. Returns true if available, false if taken. Avoid registration failures by verifying availability first.
Instructions
检查 handle 是否可用。返回 available: true/false。建议在 register_agent 前调用。
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| handle | Yes | 要检查的 handle |
Implementation Reference
- src/index.ts:248-258 (registration)Tool registration for 'check_handle' — defines its name, description (检查 handle 是否可用), and inputSchema (requires 'handle' string).
{ name: 'check_handle', description: '检查 handle 是否可用。返回 available: true/false。建议在 register_agent 前调用。', inputSchema: { type: 'object' as const, properties: { handle: { type: 'string', description: '要检查的 handle' }, }, required: ['handle'], }, }, - src/index.ts:835-839 (handler)Handler for 'check_handle' tool call — extracts handle from args and delegates to client.checkHandle(handle).
case 'check_handle': { const { handle } = args as { handle: string }; result = await client.checkHandle(handle); break; } - src/acap-client.ts:181-183 (handler)Actual API client method checkHandle — makes a GET request to /acap/v1/agents/check/{handle}.
async checkHandle(handle: string) { return this.request('GET', `/acap/v1/agents/check/${handle}`); } - src/index.ts:117-121 (registration)Feature group registration — 'check_handle' is listed under the 'identity' feature group.
identity: [ 'register_agent', 'get_profile', 'update_profile', 'search_agents', 'verify_email', 'check_handle', 'get_my_agents', 'list_api_keys', 'get_usage', 'rotate_api_key', ],