{"id":"yosefhayim-ebay-mcp","name":"ebay-mcp","homepage":"https://www.npmjs.com/package/ebay-mcp","repo_url":"https://github.com/YosefHayim/ebay-mcp","category":"api-gateway","subcategories":[],"tags":["mcp","ebay","oauth2","api-wrapper","local-server","inventory","orders","marketing","typescript"],"what_it_does":"ebay-mcp is a local Model Context Protocol (MCP) server (STDIO/optionally HTTP) that exposes ~325 tools for accessing eBay Sell REST APIs, including inventory, orders, marketing, analytics, and OAuth/token management. It provides an interactive setup wizard to configure eBay credentials and perform OAuth 2.0 to obtain/refresh user tokens.","use_cases":["Build AI assistants that can manage eBay inventory (listings, offers, SKU/location mapping)","Automate order retrieval and fulfillment workflows (orders, refunds, disputes evidence)","Generate and manage marketing campaigns/promotions via AI","Query seller analytics/metrics and operational data for decision support","Perform eBay developer/admin tasks like checking rate limits or signing keys via tool calls"],"not_for":["Replacing your own compliance, approvals, and business logic for high-risk actions (e.g., cancellations/refunds)","Unattended production workloads without monitoring and rate-limit/backoff controls","Apps that require a first-party, managed eBay integration (this is an unofficial third-party MCP server)"],"best_when":"You want local, tool-based eBay automation through an MCP-capable AI client and you can securely manage OAuth credentials and run the server in your environment.","avoid_when":"You need a hosted SaaS integration with centralized security controls, or you cannot handle secure storage of Client Secret/refresh tokens.","alternatives":["Direct use of eBay Sell APIs with your own integration (REST client)","Use eBay SDKs/wrappers in your preferred backend language and expose your own tool interface","Other MCP servers/wrappers targeting eBay or generic commerce APIs"],"af_score":72.8,"security_score":59.0,"reliability_score":42.5,"package_type":"mcp_server","discovery_source":["github"],"priority":"high","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-03-30T15:25:57.476542+00:00","interface":{"has_rest_api":false,"has_graphql":false,"has_grpc":false,"has_mcp_server":true,"mcp_server_url":null,"has_sdk":false,"sdk_languages":["TypeScript","JavaScript"],"openapi_spec_url":null,"webhooks":false},"auth":{"methods":["OAuth 2.0 user tokens (refresh token management)","OAuth 2.0 client credentials fallback (Client ID/Client Secret)"],"oauth":true,"scopes":false,"notes":"README indicates automatic fallback between user-token authentication (higher rate limits) and client credentials. Specific OAuth scopes/granularity are not described in the provided content."},"pricing":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":[],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"This appears to be a local open-source package; costs primarily come from eBay API usage and your infrastructure/compute."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":[],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":72.8,"security_score":59.0,"reliability_score":42.5,"mcp_server_quality":85.0,"documentation_accuracy":70.0,"error_message_quality":0.0,"error_message_notes":null,"auth_complexity":65.0,"rate_limit_clarity":85.0,"tls_enforcement":70.0,"auth_strength":75.0,"scope_granularity":30.0,"dependency_hygiene":55.0,"secret_handling":60.0,"security_notes":"Strengths/positives inferred from provided content: uses OAuth 2.0 with refresh token management; uses helmet (dependency listed) suggesting some HTTP hardening if HTTP transport is used; environment-variable based configuration via dotenv. Uncertainties/concerns: provided content does not show TLS requirements explicitly, how refresh tokens are stored/secured, whether logs redact secrets, or OAuth scope granularity. Secret handling and dependency hygiene can’t be verified from the excerpt alone.","uptime_documented":0.0,"version_stability":60.0,"breaking_changes_history":40.0,"error_recovery":70.0,"idempotency_support":"false","idempotency_notes":null,"pagination_style":"none","retry_guidance_documented":true,"known_agent_gotchas":["Running as a local MCP server means tool calls depend on correct local environment configuration (.env) and OAuth completion.","Some tools can trigger side effects (e.g., offers/fulfillment); ensure your agent has appropriate guardrails and you understand idempotency for each eBay endpoint.","Rate limit behavior depends on whether user tokens vs client credentials are used; tool actions may fail or slow down without backoff handling.","Large number of tools (~325) increases the chance of the agent invoking unintended endpoints; constrain/whitelist tools in the MCP client if possible."]}}