{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_8utkup42bede","handle":"mcp-buy123-vendor","url":"https://wellknown.network/agents/mcp-buy123-vendor","links":{"self":"https://wellknown.network/agents/mcp-buy123-vendor/record.json","html":"https://wellknown.network/agents/mcp-buy123-vendor","markdown":"https://wellknown.network/agents/mcp-buy123-vendor/record.md","api":"https://wellknown.network/api/v1/agents/mcp-buy123-vendor","status":"https://wellknown.network/api/v1/agents/mcp-buy123-vendor/status","claim":"https://wellknown.network/agents/mcp-buy123-vendor/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mcp-buy123-vendor/claim.json","badge":"https://wellknown.network/agents/mcp-buy123-vendor/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mcp-buy123-vendor/history","tools":"https://wellknown.network/api/v1/agents/mcp-buy123-vendor/tools"},"ard":{"identifier":"urn:air::server:mcp-buy123-vendor","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcp-buy123-vendor","summary":"Model Context Protocol server for read-only buy123 vendor portal queries","description":"# mcp-buy123-vendor\n\n`mcp-buy123-vendor` is an open-source [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server for the buy123 vendor portal. It gives AI clients such as Claude Desktop, Claude Code, and other MCP-compatible agents read-only tools for querying vendor operations data, including orders, returns, shipments, products, bundles, channels, inventory, permissions, and vendor profile records.\n\nThis project is useful when you want an AI assistant to inspect buy123 vendor data through structured MCP tools instead of manually browsing the vendor portal.\n\n> **Legal prerequisite**: This tool requires a legitimate vendor account on the buy123 platform. You must hold a valid vendor identity and comply with the platform's terms of service. Unauthorized access is not supported.\n>\n> **Unofficial project**: This repository is community-maintained and is not an official product of, or endorsed by, buy123.\n\nTraditional Chinese documentation is available in [README.zh-TW.md](README.zh-TW.md).\n\n## Highlights\n\n- MCP server for buy123 vendor portal data access\n- Read-only query tools for vendor operations workflows\n- Claude Desktop and Claude Code compatible local MCP configuration\n- Interactive on-demand login flow with local token storage\n- Offline unit test suite for safe local development\n\n## Provided Tools\n\n**59 AI-callable tools** — all query-only. Every tool returns the upstream API response envelope: `{ success, msg, data, pagination? }`.\n\n### General Enumerations (no login required — 14 tools)\n\n`list_banks`, `list_bundle_types`, `list_bundle_delivery_notes`, `list_bundle_delivery_statuses`, `list_delivery_types`, `list_packaging_types`, `list_invoice_types`, `list_product_statuses`, `list_event_product_statuses`, `list_gross_profit_statuses`, `list_review_statuses`, `list_announcement_notify_levels`, `list_announcement_notify_scopes`, `list_announcement_notify_types`\n\n### Query Tools (login required — 45 tools)\n\n| Category | Tools |\n|----------|--…","publisher":null,"homepage":"https://github.com/asgard-ai-platform/mcp-buy123-vendor#readme","repository":"https://github.com/asgard-ai-platform/mcp-buy123-vendor#readme","version":"0.1.0","license":"MIT","protocols":["mcp"],"tags":["mcp","model-context-protocol","mcp-server","claude","claude-desktop","claude-code","buy123","vendor-portal","vendor-api","ai-tools","automation"],"pricing":null,"endpoints":[{"url":"pypi:mcp-buy123-vendor","type":"package_pypi","auth":null,"probeable":false,"listed":true}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"commerce.ecommerce","name":"E-commerce Operations","confidence":1,"provenance":"derived"},{"slug":"security.identity","name":"Identity & Access","confidence":0.859,"provenance":"derived"},{"slug":"code.documentation","name":"Code Documentation","confidence":0.848,"provenance":"derived"}],"categories":["code","commerce","security"],"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":"mcp-buy123-vendor","registry":"pypi","observedAt":"2026-11-09T14:28:01.501Z","publishedAt":"2026-05-12T03:35:30.744169Z","latestVersion":"0.1.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcp-buy123-vendor","url":"https://pypi.org/project/mcp-buy123-vendor/","firstSeenAt":"2026-09-10T00:24:39.183Z","fetchedAt":"2026-11-09T14:26:45.052Z","normalizedAt":"2026-11-09T14:26:45.052Z"}]},"firstSeenAt":"2026-09-10T00:24:39.183Z","updatedAt":"2026-11-09T14:28:01.501Z"}