Account Management - eBay MCP Server

The eBay MCP Server provides complete account management capabilities through the Account API, offering 30 specialized tools to configure policies, manage seller programs, handle sales tax, and control account settings.

Overview

The Account API is essential for setting up and managing your eBay seller account. Properly configured policies and settings ensure smooth transactions, legal compliance, and eligibility for seller programs.

Account Management Essentials:

Business Policies: Fulfillment, payment, and return policies for listings
Seller Programs: Opt into programs for benefits and features
Sales Tax: Configure tax collection by jurisdiction
Account Settings: KYC status, privileges, and subscriptions

Core Capabilities

Business Policies

Create reusable fulfillment, payment, and return policies

Sales Tax Management

Configure tax rates by state and jurisdiction

Seller Programs

Opt into programs for enhanced features

Account Settings

Manage KYC, privileges, and subscriptions

Business Policies

Business policies are reusable templates that define shipping, payment, and return rules for your listings. They streamline listing creation and ensure consistency.

Policy Types

Fulfillment Policies
Payment Policies
Return Policies
Custom Policies

Define shipping and handling

Shipping services and costs
Handling time
Free shipping options
International shipping
Local pickup availability

{
  "policy": {
    "name": "Standard Shipping - US",
    "marketplaceId": "EBAY_US",
    "categoryTypes": [{"name": "ALL_EXCLUDING_MOTORS_VEHICLES"}],
    "handlingTime": {
      "value": 1,
      "unit": "BUSINESS_DAY"
    },
    "shippingOptions": [
      {
        "costType": "FLAT_RATE",
        "shippingServices": [
          {
            "shippingCarrierCode": "USPS",
            "shippingServiceCode": "USPSPriority",
            "freeShipping": false,
            "shippingCost": {
              "value": "8.99",
              "currency": "USD"
            }
          }
        ]
      }
    ]
  }
}

Managing Fulfillment Policies

Get Existing Policies

{
  "marketplaceId": "EBAY_US"
}

Tools:

ebay_get_fulfillment_policies - List all fulfillment policies
ebay_get_fulfillment_policy - Get policy by ID
ebay_get_fulfillment_policy_by_name - Find by name

Create New Policy

Tool: ebay_create_fulfillment_policyRequired Fields:

Policy name
Marketplace ID
Category types
Handling time
At least one shipping option

Update or Delete

Tools:

ebay_update_fulfillment_policy - Modify existing policy
ebay_delete_fulfillment_policy - Remove policy

Note: Cannot delete policies currently in use by active listings

Managing Payment and Return Policies

The same create, read, update, delete pattern applies to all policy types: Payment Policies (5 tools):

ebay_create_payment_policy
ebay_get_payment_policies
ebay_get_payment_policy
ebay_get_payment_policy_by_name
ebay_update_payment_policy
ebay_delete_payment_policy

Return Policies (5 tools):

ebay_create_return_policy
ebay_get_return_policies
ebay_get_return_policy
ebay_get_return_policy_by_name
ebay_update_return_policy
ebay_delete_return_policy

Custom Policies (4 tools):

ebay_create_custom_policy
ebay_get_custom_policies
ebay_get_custom_policy
ebay_update_custom_policy
ebay_delete_custom_policy

Sales Tax Management

Configure sales tax collection for jurisdictions where you’re required to collect tax.

Understanding Sales Tax

Important: eBay automatically calculates and collects Internet Sales Tax in many U.S. states. You only need to configure additional tax rates if required by your state or for specific jurisdictions.

Managing Sales Tax Tables

Get Existing Tax Tables

{
  "countryCode": "US"
}

Tool: ebay_get_sales_taxesReturns all configured tax rates for the specified country

Create or Update Tax Rate

{
  "countryCode": "US",
  "jurisdictionId": "CA",
  "salesTaxBase": {
    "salesTaxPercentage": "7.25",
    "shippingAndHandlingTaxed": false
  }
}

Tool: ebay_create_or_replace_sales_taxJurisdiction IDs:

Use two-letter state codes for U.S. states (CA, NY, TX, etc.)
Contact eBay for other jurisdiction codes

Bulk Operations

Configure multiple jurisdictions at once:

{
  "requests": [
    {
      "countryCode": "US",
      "jurisdictionId": "CA",
      "salesTaxBase": {
        "salesTaxPercentage": "7.25",
        "shippingAndHandlingTaxed": false
      }
    },
    {
      "countryCode": "US",
      "jurisdictionId": "NY",
      "salesTaxBase": {
        "salesTaxPercentage": "4.00",
        "shippingAndHandlingTaxed": false
      }
    }
  ]
}

Tool: ebay_bulk_create_or_replace_sales_tax

Delete Tax Table

{
  "countryCode": "US",
  "jurisdictionId": "CA"
}

Tool: ebay_delete_sales_tax

Tax Compliance: Consult with a tax professional to ensure you’re collecting the correct tax rates and complying with all applicable laws.

Seller Programs

Opt into eBay seller programs to access enhanced features, benefits, and selling tools.

Available Programs

Top Rated Seller

Premium seller status with fee discounts and badge

eBay Payments

Integrated payment processing (standard for all sellers)

Advertising Programs

Access to promoted listings and marketing tools

Out of Stock Control

Keep listings active when out of stock

Program Management

Check Opted-In Programs

{}  // No parameters required

Tool: ebay_get_opted_in_programsReturns all programs you’re currently enrolled in

Check Program Eligibility

{
  "marketplaceId": "EBAY_US",
  "programTypes": "PROMOTED_LISTINGS_STANDARD"
}

Tool: ebay_get_advertising_eligibilityCheck if you qualify for advertising programs

Opt In to Program

{
  "request": {
    "programType": "OUT_OF_STOCK_CONTROL"
  }
}

Tool: ebay_opt_in_to_program

Opt Out of Program

{
  "request": {
    "programType": "OUT_OF_STOCK_CONTROL"
  }
}

Tool: ebay_opt_out_of_program

Payment Program Tools

eBay Payments Program (Deprecated):All sellers are now automatically enrolled in eBay’s managed payments. These tools remain for compatibility:

ebay_opt_in_to_payments_program
ebay_get_payments_program_status
ebay_get_payments_program
ebay_get_payments_program_onboarding

These methods are deprecated as all seller accounts globally have been enabled for the new eBay payment and checkout flow.

Account Settings and Information

Access seller account information, privileges, and subscription details.

KYC Status

Know Your Customer (KYC) verification is required for selling on eBay:

{}  // No parameters required

Tool: ebay_get_kyc Returns:

Verification status
Required documents
Completion percentage
Next steps

Seller Privileges

Check your account’s selling limits and privileges:

{}  // No parameters required

Tool: ebay_get_privileges Returns:

Selling limit (quantity and value)
Registration completion status
Special privileges
Account restrictions

Example Privileges Response

{
  "sellingLimit": {
    "quantity": 100,
    "amount": {
      "value": "5000.00",
      "currency": "USD"
    }
  },
  "sellerRegistrationCompleted": true,
  "specialPrivileges": [
    "SELL_MOTORS_VEHICLES"
  ]
}

Subscription Information

View your eBay Store subscription and fee structure:

{
  "limitType": "SELLING_LIMIT"  // Optional filter
}

Tool: ebay_get_subscription Returns:

Subscription tier (Basic, Premium, Anchor, Enterprise)
Monthly fees
Listing allowances
Final value fee discounts

Rate Tables

Get shipping rate tables configured for your account:

{}  // No parameters required

Tool: ebay_get_rate_tables Returns configured shipping rate tables for calculated shipping

Common Use Cases

Setting Up a New Seller Account

Complete setup workflow:

Check KYC status: ebay_get_kyc
Check privileges: ebay_get_privileges
Create fulfillment policy: ebay_create_fulfillment_policy
Create payment policy: ebay_create_payment_policy
Create return policy: ebay_create_return_policy
Configure sales tax: ebay_create_or_replace_sales_tax
Opt into programs: ebay_opt_in_to_program

Now you’re ready to create listings!

Updating Shipping Costs

Adjust shipping across all listings:

Get current policies: ebay_get_fulfillment_policies
Update policy: ebay_update_fulfillment_policy
Changes apply immediately to all listings using the policy

Configuring Multi-State Sales Tax

Set up tax for multiple states:

Determine tax obligations
Use ebay_bulk_create_or_replace_sales_tax with all jurisdictions
Verify with ebay_get_sales_taxes

Checking Account Limits

Monitor selling capacity:

Get privileges: ebay_get_privileges
Check current month sales against limits
Request increase if needed (via eBay Seller Hub)

Tool Reference

Fulfillment Policies (5 tools)

ebay_get_fulfillment_policies - List all policies
ebay_get_fulfillment_policy - Get by ID
ebay_get_fulfillment_policy_by_name - Get by name
ebay_create_fulfillment_policy - Create new policy
ebay_update_fulfillment_policy - Update policy
ebay_delete_fulfillment_policy - Delete policy

Payment Policies (5 tools)

ebay_get_payment_policies - List all policies
ebay_get_payment_policy - Get by ID
ebay_get_payment_policy_by_name - Get by name
ebay_create_payment_policy - Create new policy
ebay_update_payment_policy - Update policy
ebay_delete_payment_policy - Delete policy

Return Policies (5 tools)

ebay_get_return_policies - List all policies
ebay_get_return_policy - Get by ID
ebay_get_return_policy_by_name - Get by name
ebay_create_return_policy - Create new policy
ebay_update_return_policy - Update policy
ebay_delete_return_policy - Delete policy

Custom Policies (4 tools)

ebay_get_custom_policies - List all policies
ebay_get_custom_policy - Get by ID
ebay_create_custom_policy - Create new policy
ebay_update_custom_policy - Update policy
ebay_delete_custom_policy - Delete policy

Sales Tax (5 tools)

ebay_get_sales_taxes - Get all tax tables for country
ebay_get_sales_tax - Get specific jurisdiction
ebay_create_or_replace_sales_tax - Set tax rate
ebay_bulk_create_or_replace_sales_tax - Bulk set rates
ebay_delete_sales_tax - Remove tax table

Programs (5 tools)

ebay_get_opted_in_programs - List enrolled programs
ebay_opt_in_to_program - Join program
ebay_opt_out_of_program - Leave program
ebay_get_advertising_eligibility - Check ad program eligibility
ebay_opt_in_to_payments_program - Deprecated
ebay_get_payments_program_status - Deprecated
ebay_get_payments_program - Deprecated
ebay_get_payments_program_onboarding - Deprecated

Account Information (3 tools)

ebay_get_kyc - KYC verification status
ebay_get_privileges - Selling limits and privileges
ebay_get_subscription - Store subscription details
ebay_get_rate_tables - Shipping rate tables

Best Practices

Create Policy Templates

Set up reusable policies for common scenarios (domestic, international, etc.)

Update Policies Centrally

Modify policies instead of individual listings to ensure consistency

Review Tax Settings Annually

Sales tax laws change - verify your configuration yearly

Monitor Account Limits

Track selling limits to avoid hitting caps during peak seasons

Policy Naming Conventions

Recommended naming:

Fulfillment: “Standard - US” or “Expedited - International”
Payment: “Immediate Pay” or “Standard Payment”
Return: “30 Day Returns” or “No Returns Accepted”

Clear names make policy selection easier when creating listings.

Next Steps

Creating Your First Listing

Use your configured policies to create listings

Inventory Management

Start adding products to your catalog

Account API Reference

Complete API documentation

Best Practices Guide

Optimize your seller account

Rate Limits

User Tokens: 10,000-50,000 requests/dayRecommendation: Policy operations are typically one-time setup. Batch policy creation during initial setup.

See Rate Limits for detailed information.

Getting Started

Authentication

Core Features

Guides

MCP Integration

Advanced

Support

​Overview

​Core Capabilities

Business Policies

Sales Tax Management

Seller Programs

Account Settings

​Business Policies

​Policy Types

​Managing Fulfillment Policies

​Managing Payment and Return Policies

​Sales Tax Management

​Understanding Sales Tax

​Managing Sales Tax Tables

​Seller Programs

​Available Programs

Top Rated Seller

eBay Payments

Advertising Programs

Out of Stock Control

​Program Management

​Account Settings and Information

​KYC Status

​Seller Privileges

​Subscription Information

​Rate Tables

​Common Use Cases

​Tool Reference

​Fulfillment Policies (5 tools)

​Payment Policies (5 tools)

​Return Policies (5 tools)

​Custom Policies (4 tools)

​Sales Tax (5 tools)

​Programs (5 tools)

​Account Information (3 tools)

​Best Practices

Create Policy Templates

Update Policies Centrally

Review Tax Settings Annually

Monitor Account Limits

​Policy Naming Conventions

​Next Steps

Creating Your First Listing

Inventory Management

Account API Reference

Best Practices Guide

​Rate Limits

Overview

Core Capabilities

Business Policies

Policy Types

Managing Fulfillment Policies

Managing Payment and Return Policies

Sales Tax Management

Understanding Sales Tax

Managing Sales Tax Tables

Seller Programs

Available Programs

Program Management

Account Settings and Information

KYC Status

Seller Privileges

Subscription Information

Rate Tables

Common Use Cases

Tool Reference

Fulfillment Policies (5 tools)

Payment Policies (5 tools)

Return Policies (5 tools)

Custom Policies (4 tools)

Sales Tax (5 tools)

Programs (5 tools)

Account Information (3 tools)

Best Practices

Policy Naming Conventions

Next Steps

Rate Limits