Metadata-Version: 2.4
Name: easyship-mcp
Version: 0.1.1
Summary: MCP server for Easyship — get shipping rates and track shipments
Project-URL: Homepage, https://github.com/easyship/easyship-mcp
Project-URL: Repository, https://github.com/easyship/easyship-mcp
Project-URL: Issues, https://github.com/easyship/easyship-mcp/issues
Project-URL: Documentation, https://developers.easyship.com
Author-email: Easyship <support@easyship.com>
License-Expression: MIT
License-File: LICENSE
Keywords: easyship,mcp,rates,shipping,tracking
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.10
Requires-Dist: fastmcp>=2.0.0
Requires-Dist: httpx>=0.27.0
Description-Content-Type: text/markdown

<!-- mcp-name: com.easyship/mcp -->
# Easyship MCP Server

MCP server for [Easyship](https://www.easyship.com) — get shipping rates and track shipments.

## Tools

- **get_shipping_rates** — compare courier options with prices and delivery times for a parcel
- **track_shipment** — get current status and checkpoint history for a shipment

## Quick Start

### Claude Desktop

Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "easyship": {
      "command": "uvx",
      "args": ["easyship-mcp"],
      "env": {
        "EASYSHIP_API_ACCESS_TOKEN": "your-key-here"
      }
    }
  }
}
```

### Claude Code

```bash
claude mcp add easyship -- uvx easyship-mcp
```

Then set `EASYSHIP_API_ACCESS_TOKEN` in your environment.

## Configuration

Get your API key from [Easyship Dashboard → Connect → API](https://app.easyship.com/connect/api).

```bash
export EASYSHIP_API_ACCESS_TOKEN="your-key-here"
```

## Install from source

```bash
pip install -e .
```

## Usage examples

**Get shipping rates:**
> "What are the shipping options for a 1.5kg package (30×20×15 cm) from Hong Kong to New York?"

**Track a shipment:**
> "Track shipment ESSG10006001"

## API version

This server targets the Easyship API **v2024-09**.

## License

MIT
