ebay-mcp-remote-edition 1.0.0

package/docs/auth/production_scopes.json

@@ -0,0 +1,111 @@
+[
+  {
+      "Scope": "https://api.ebay.com/oauth/api_scope",
+      "Description": "View public data from eBay"
+  },
+  {
+      "Scope": "https://api.ebay.com/oauth/api_scope/sell.marketing.readonly",
+      "Description": "View your eBay marketing activities, such as ad campaigns and listing promotions"
+  },
+  {
+      "Scope": "https://api.ebay.com/oauth/api_scope/sell.marketing",
+      "Description": "View and manage your eBay marketing activities, such as ad campaigns and listing promotions"
+  },
+  {
+      "Scope": "https://api.ebay.com/oauth/api_scope/sell.inventory.readonly",
+      "Description": "View your inventory and offers"
+  },
+  {
+      "Scope": "https://api.ebay.com/oauth/api_scope/sell.inventory",
+      "Description": "View and manage your inventory and offers"
+  },
+  {
+      "Scope": "https://api.ebay.com/oauth/api_scope/sell.account.readonly",
+      "Description": "View your account settings"
+  },
+  {
+      "Scope": "https://api.ebay.com/oauth/api_scope/sell.account",
+      "Description": "View and manage your account settings"
+  },
+  {
+      "Scope": "https://api.ebay.com/oauth/api_scope/sell.fulfillment.readonly",
+      "Description": "View your order fulfillments"
+  },
+  {
+      "Scope": "https://api.ebay.com/oauth/api_scope/sell.fulfillment",
+      "Description": "View and manage your order fulfillments"
+  },
+  {
+      "Scope": "https://api.ebay.com/oauth/api_scope/sell.analytics.readonly",
+      "Description": "View your selling analytics data, such as performance reports"
+  },
+  {
+      "Scope": "https://api.ebay.com/oauth/api_scope/sell.finances",
+      "Description": "View and manage your payment and order information to display this information to you and allow you to initiate refunds using the third party application"
+  },
+  {
+      "Scope": "https://api.ebay.com/oauth/api_scope/sell.payment.dispute",
+      "Description": "View and manage disputes and related details (including payment and order information)."
+  },
+  {
+      "Scope": "https://api.ebay.com/oauth/api_scope/commerce.identity.readonly",
+      "Description": "View a user's basic information, such as username or business account details, from their eBay member account"
+  },
+  {
+      "Scope": "https://api.ebay.com/oauth/api_scope/sell.reputation",
+      "Description": "View and manage your reputation data, such as feedback."
+  },
+  {
+      "Scope": "https://api.ebay.com/oauth/api_scope/sell.reputation.readonly",
+      "Description": "View your reputation data, such as feedback."
+  },
+  {
+      "Scope": "https://api.ebay.com/oauth/api_scope/commerce.notification.subscription",
+      "Description": "View and manage your event notification subscriptions"
+  },
+  {
+      "Scope": "https://api.ebay.com/oauth/api_scope/commerce.notification.subscription.readonly",
+      "Description": "View your event notification subscriptions"
+  },
+  {
+      "Scope": "https://api.ebay.com/oauth/api_scope/sell.stores",
+      "Description": "View and manage eBay stores"
+  },
+  {
+      "Scope": "https://api.ebay.com/oauth/api_scope/sell.stores.readonly",
+      "Description": "View eBay stores"
+  },
+  {
+      "Scope": "https://api.ebay.com/oauth/scope/sell.edelivery",
+      "Description": "Allows access to eDelivery International Shipping APIs."
+  },
+  {
+      "Scope": "https://api.ebay.com/oauth/api_scope/commerce.vero",
+      "Description": "Allows access to APIs that are related to eBay's Verified Rights Owner (VeRO) program."
+  },
+  {
+      "Scope": "https://api.ebay.com/oauth/api_scope/sell.inventory.mapping",
+      "Description": "Enables applications to manage and enhance inventory listings through the Inventory Mapping Public API."
+  },
+  {
+      "Scope": "https://api.ebay.com/oauth/api_scope/commerce.message",
+      "Description": "Allows access to eBay Message APIs."
+  },
+  {
+      "Scope": "https://api.ebay.com/oauth/api_scope/commerce.feedback",
+      "Description": "Allows access to Feedback APIs."
+  },
+  {
+      "Scope": "https://api.ebay.com/oauth/api_scope/commerce.shipping",
+      "Description": "View and manage shipping information"
+  },
+  {},
+  {
+      "Scope": "https://api.ebay.com/oauth/api_scope",
+      "Description": "View public data from eBay"
+  },
+  {
+      "Scope": "https://api.ebay.com/oauth/api_scope/commerce.feedback.readonly",
+      "Description": "Allows readonly access to Feedback APIs."
+  }
+]

package/docs/auth/sandbox_scopes.json

@@ -0,0 +1,142 @@
+[
+  {
+      "Scope": "https://api.ebay.com/oauth/api_scope",
+      "Description": "View public data from eBay"
+  },
+  {
+      "Scope": "https://api.ebay.com/oauth/api_scope/buy.order.readonly",
+      "Description": "View your order details"
+  },
+  {
+      "Scope": "https://api.ebay.com/oauth/api_scope/buy.guest.order",
+      "Description": "Purchase eBay items off eBay"
+  },
+  {
+      "Scope": "https://api.ebay.com/oauth/api_scope/sell.marketing.readonly",
+      "Description": "View your eBay marketing activities, such as ad campaigns and listing promotions"
+  },
+  {
+      "Scope": "https://api.ebay.com/oauth/api_scope/sell.marketing",
+      "Description": "View and manage your eBay marketing activities, such as ad campaigns and listing promotions"
+  },
+  {
+      "Scope": "https://api.ebay.com/oauth/api_scope/sell.inventory.readonly",
+      "Description": "View your inventory and offers"
+  },
+  {
+      "Scope": "https://api.ebay.com/oauth/api_scope/sell.inventory",
+      "Description": "View and manage your inventory and offers"
+  },
+  {
+      "Scope": "https://api.ebay.com/oauth/api_scope/sell.account.readonly",
+      "Description": "View your account settings"
+  },
+  {
+      "Scope": "https://api.ebay.com/oauth/api_scope/sell.account",
+      "Description": "View and manage your account settings"
+  },
+  {
+      "Scope": "https://api.ebay.com/oauth/api_scope/sell.fulfillment.readonly",
+      "Description": "View your order fulfillments"
+  },
+  {
+      "Scope": "https://api.ebay.com/oauth/api_scope/sell.fulfillment",
+      "Description": "View and manage your order fulfillments"
+  },
+  {
+      "Scope": "https://api.ebay.com/oauth/api_scope/sell.analytics.readonly",
+      "Description": "View your selling analytics data, such as performance reports"
+  },
+  {
+      "Scope": "https://api.ebay.com/oauth/api_scope/sell.marketplace.insights.readonly",
+      "Description": "This scope would allow signed in users read only access to marketplace insights."
+  },
+  {
+      "Scope": "https://api.ebay.com/oauth/api_scope/commerce.catalog.readonly",
+      "Description": "This scope would allow signed in user to read catalog data."
+  },
+  {
+      "Scope": "https://api.ebay.com/oauth/api_scope/buy.shopping.cart",
+      "Description": "This scope would allow signed in user to access shopping carts"
+  },
+  {
+      "Scope": "https://api.ebay.com/oauth/api_scope/buy.offer.auction",
+      "Description": "View and manage bidding activities for auctions"
+  },
+  {
+      "Scope": "https://api.ebay.com/oauth/api_scope/commerce.identity.readonly",
+      "Description": "View a user's basic information, such as username or business account details, from their eBay member account"
+  },
+  {
+      "Scope": "https://api.ebay.com/oauth/api_scope/commerce.identity.email.readonly",
+      "Description": "View a user's personal email information from their eBay member account"
+  },
+  {
+      "Scope": "https://api.ebay.com/oauth/api_scope/commerce.identity.phone.readonly",
+      "Description": "View a user's personal telephone information from their eBay member account"
+  },
+  {
+      "Scope": "https://api.ebay.com/oauth/api_scope/commerce.identity.address.readonly",
+      "Description": "View a user's personal address information from their eBay member account"
+  },
+  {
+      "Scope": "https://api.ebay.com/oauth/api_scope/commerce.identity.name.readonly",
+      "Description": "View a user's first and last name from their eBay member account"
+  },
+  {
+      "Scope": "https://api.ebay.com/oauth/api_scope/commerce.identity.status.readonly",
+      "Description": "View a user's eBay member account status"
+  },
+  {
+      "Scope": "https://api.ebay.com/oauth/api_scope/sell.finances",
+      "Description": "View and manage your payment and order information to display this information to you and allow you to initiate refunds using the third party application"
+  },
+  {
+      "Scope": "https://api.ebay.com/oauth/api_scope/sell.payment.dispute",
+      "Description": "View and manage disputes and related details (including payment and order information)."
+  },
+  {
+      "Scope": "https://api.ebay.com/oauth/api_scope/sell.item.draft",
+      "Description": "View and manage your item drafts."
+  },
+  {
+      "Scope": "https://api.ebay.com/oauth/api_scope/sell.item",
+      "Description": "View and manage your item information."
+  },
+  {
+      "Scope": "https://api.ebay.com/oauth/api_scope/sell.reputation",
+      "Description": "View and manage your reputation data, such as feedback."
+  },
+  {
+      "Scope": "https://api.ebay.com/oauth/api_scope/sell.reputation.readonly",
+      "Description": "View your reputation data, such as feedback."
+  },
+  {
+      "Scope": "https://api.ebay.com/oauth/api_scope/commerce.notification.subscription",
+      "Description": "View and manage your event notification subscriptions"
+  },
+  {
+      "Scope": "https://api.ebay.com/oauth/api_scope/commerce.notification.subscription.readonly",
+      "Description": "View your event notification subscriptions"
+  },
+  {
+      "Scope": "https://api.ebay.com/oauth/api_scope/sell.stores",
+      "Description": "View and manage eBay stores"
+  },
+  {
+      "Scope": "https://api.ebay.com/oauth/api_scope/sell.stores.readonly",
+      "Description": "View eBay stores"
+  },
+  {
+      "Scope": "https://api.ebay.com/oauth/api_scope/commerce.vero",
+      "Description": "Allows access to APIs that are related to eBay's Verified Rights Owner (VeRO) program."
+  },
+  {
+      "Scope": "https://api.ebay.com/oauth/api_scope/commerce.feedback",
+      "Description": "Allows access to Feedback APIs."
+  },
+  {
+      "Scope": "https://api.ebay.com/oauth/api_scope/sell.inventory.mapping",
+      "Description": "Enables applications to manage and enhance inventory listings through the Inventory Mapping Public API."
+  }
+]

package/package.json

@@ -0,0 +1,122 @@
+{
+  "name": "ebay-mcp-remote-edition",
+  "version": "1.0.0",
+  "description": "MCP server for eBay Sell APIs — 325+ tools for inventory, orders, marketing, analytics, and more. Supports local STDIO and hosted multi-user HTTP modes.",
+  "type": "module",
+  "main": "build/index.js",
+  "types": "build/index.d.ts",
+  "bin": {
+    "ebay-mcp-remote-edition": "build/index.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc && tsc-alias",
+    "start": "node build/index.js",
+    "start:http": "node build/server-http.js",
+    "dev": "tsx src/index.ts",
+    "dev:http": "tsx src/server-http.ts",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "setup": "tsx src/scripts/setup.ts",
+    "sync": "tsx src/scripts/dev-sync.ts",
+    "diagnose": "tsx src/scripts/diagnostics.ts",
+    "typecheck": "tsc --noEmit",
+    "check": "tsc --noEmit && eslint . && prettier --check \"src/**/*.{ts,js,json,md}\"",
+    "fix": "eslint . --fix && prettier --write \"src/**/*.{ts,js,json,md}\"",
+    "prepare": "pnpm run build"
+  },
+  "keywords": [
+    "mcp",
+    "ebay",
+    "ebay-api",
+    "model-context-protocol",
+    "ai-tools",
+    "ai",
+    "llm",
+    "mcp",
+    "documentation",
+    "api",
+    "ebay",
+    "server",
+    "backend"
+  ],
+  "author": {
+    "name": "YosefHayim",
+    "url": "https://github.com/YosefHayim"
+  },
+  "contributors": [
+    {
+      "name": "Kenyatta Naji Johnson-Adams",
+      "url": "https://github.com/mrnajiboy"
+    }
+  ],
+  "license": "MIT",
+  "files": [
+    "build/**/*.js",
+    "build/index.d.ts",
+    "build/server-http.d.ts",
+    "public/icons/*.png",
+    "README.md",
+    "docs/auth/production_scopes.json",
+    "docs/auth/sandbox_scopes.json"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mrnajiboy/ebay-mcp-remote-edition.git"
+  },
+  "homepage": "https://github.com/mrnajiboy/ebay-mcp-remote-edition#readme",
+  "bugs": {
+    "url": "https://github.com/mrnajiboy/ebay-mcp-remote-edition/issues"
+  },
+  "npmLink": "https://www.npmjs.com/package/ebay-mcp-remote-edition",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "axios": "^1.13.6",
+    "chalk": "^5.6.2",
+    "cors": "^2.8.5",
+    "dotenv": "^17.2.3",
+    "dotenv-stringify": "^3.0.1",
+    "express": "^5.1.0",
+    "fast-xml-parser": "^5.5.6",
+    "helmet": "^8.1.0",
+    "jose": "^6.1.2",
+    "jsonwebtoken": "^9.0.2",
+    "prompts": "^2.4.2",
+    "update-notifier": "^7.3.1",
+    "winston": "^3.19.0",
+    "zod": "^3.23.8",
+    "zod-to-json-schema": "^3.24.1"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.1",
+    "@types/cors": "^2.8.19",
+    "@types/express": "^5.0.5",
+    "@types/jsonwebtoken": "^9.0.10",
+    "@types/node": "^24.10.1",
+    "@types/prompts": "^2.4.9",
+    "@types/supertest": "^6.0.3",
+    "@types/update-notifier": "^6.0.8",
+    "@vitest/coverage-v8": "^4.0.13",
+    "@vitest/ui": "^4.0.8",
+    "eslint": "^9.39.1",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-n": "^17.23.1",
+    "eslint-plugin-vitest": "^0.5.4",
+    "nock": "^14.0.10",
+    "openapi-typescript": "^7.10.1",
+    "prettier": "^3.6.2",
+    "supertest": "^7.1.4",
+    "tsc-alias": "^1.8.16",
+    "tsx": "^4.19.2",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.47.0",
+    "vitest": "^4.0.8"
+  },
+  "packageManager": "pnpm@10.14.0",
+  "engines": {
+    "node": ">=22.0.0",
+    "pnpm": ">=9.0.0"
+  }
+}