{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_28qzd3eczud9","handle":"bird-id-mcp","url":"https://wellknown.network/agents/bird-id-mcp","links":{"self":"https://wellknown.network/agents/bird-id-mcp/record.json","html":"https://wellknown.network/agents/bird-id-mcp","markdown":"https://wellknown.network/agents/bird-id-mcp/record.md","api":"https://wellknown.network/api/v1/agents/bird-id-mcp","status":"https://wellknown.network/api/v1/agents/bird-id-mcp/status","claim":"https://wellknown.network/agents/bird-id-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/bird-id-mcp/claim.json","badge":"https://wellknown.network/agents/bird-id-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:bird-id-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"bird-id-mcp","summary":"Bird species identification MCP server — YOLO detection + ConvNeXt classification, Top5 output","description":"# bird-id-mcp\n\nBird species identification MCP server. YOLO detection + ConvNeXt classification, outputs Top-5 species with confidence and Chinese names.\n\n## Install & Run\n\n```bash\n# Run directly with uvx (auto-installs)\nuvx bird-id-mcp\n\n# Or install from git\npip install git+https://github.com/Hakureirm/bird-id-mcp.git\nbird-id-mcp\n```\n\nModels are automatically downloaded from HuggingFace on first run (~50MB default).\n\n## Model Selection\n\n| Model | Size | Speed (x86 1T) | Accuracy |\n|-------|------|-----------------|----------|\n| **S1v2** (default) | 37MB | ~150ms | Good |\n| ConvNeXt | 144MB | ~600ms | Best |\n\nDefault is S1v2 (fast + small). To use ConvNeXt:\n\n```bash\nBIRD_ID_CLS_MODEL=convnext uvx --from git+https://github.com/Hakureirm/bird-id-mcp.git bird-id-mcp\n```\n\n## Claude Desktop / Agent Config\n\n```json\n{\n  \"mcpServers\": {\n    \"bird-id\": {\n      \"command\": \"uvx\",\n      \"args\": [\"bird-id-mcp\"]\n    }\n  }\n}\n```\n\n## Tools\n\n### `identify_bird`\nIdentify bird species from an image file path.\n\n```\nInput:  {\"image_path\": \"/path/to/bird.jpg\", \"topk\": 5}\nOutput: {\n  \"detections\": 1,\n  \"detection_confidence\": 0.92,\n  \"bbox\": {\"x1\": 100, \"y1\": 50, \"x2\": 400, \"y2\": 350},\n  \"results\": [\n    {\"rank\": 1, \"species\": \"Little Egret\", \"species_cn\": \"白鹭\", \"confidence\": 78.5},\n    {\"rank\": 2, \"species\": \"Snowy Egret\", \"species_cn\": \"雪鹭\", \"confidence\": 12.3},\n    ...\n  ]\n}\n```\n\n### `identify_bird_base64`\nSame as above but accepts base64-encoded image data.\n\n## Models\n\n- **Detection**: YOLOv8 bird detector (12MB ONNX)\n- **Classification**: S1v2 (37MB, default) or ConvNeXt-Tiny (144MB), 10,753 bird species\n- **Taxonomy**: eBird species info — scientific name, family, order, description\n- **Inference**: ONNX Runtime CPU only, no GPU required","publisher":{"name":"Hakureirm","url":null},"homepage":null,"repository":null,"version":"0.1.1","license":"MIT","protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:bird-id-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","summary":"pypi","version":"pypi","description":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"ai.model-access","name":"Model Access","confidence":0.905,"provenance":"derived"},{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["ai","dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"bird-id-mcp","registry":"pypi","observedAt":"2026-09-09T10:31:00.412Z","publishedAt":"2026-04-02T07:13:19.459909Z","latestVersion":"0.1.1"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"bird-id-mcp","url":"https://pypi.org/project/bird-id-mcp/","firstSeenAt":"2026-09-09T10:27:13.815Z","fetchedAt":"2026-09-09T10:27:13.815Z","normalizedAt":"2026-09-09T10:27:13.815Z"}]},"firstSeenAt":"2026-09-09T10:27:13.815Z","updatedAt":"2026-09-09T10:31:00.412Z"}