Aftership Tracking & Returns

by AfterShip

2 stars

138 downloads

Not rated

GitHub

Description

# AfterShip Tracking & Returns MCP Server Real-time package tracking and returns demo for any AI assistant — powered by [AfterShip](https://www.aftership.com). **No authentication required.** Connect instantly using the remote endpoint: ```…

About

Details

Author: AfterShip
GitHub stars: 2
Downloads: 138
Categories: Search, Other, API

- Real-time package tracking across 1,200+ carriers worldwide.
- Automatic carrier detection — no carrier knowledge needed.
- Generates live, interactive AfterShip Returns Center demos for any store URL.
- Read-only access; no personal data is returned or modified.
- No authentication required; free for personal and non‑commercial use.
- Integrates with Claude Code, Codex, Cursor, Windsurf, and VS Code Copilot.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Aftership Tracking & Returns

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "aftership tracking & returns": {
            "aftership": {
                "url": "https://mcp.aftership.com/tracking/public"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "aftership tracking & returns": {
            "aftership": {
                "url": "https://mcp.aftership.com/tracking/public"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "aftership tracking & returns": {
            "aftership": {
                "url": "https://mcp.aftership.com/tracking/public"
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "aftership tracking & returns": {
            "aftership": {
                "url": "https://mcp.aftership.com/tracking/public"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "aftership tracking & returns": {
            "aftership": {
                "url": "https://mcp.aftership.com/tracking/public"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "aftership tracking & returns": {
            "aftership": {
                "url": "https://mcp.aftership.com/tracking/public"
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "aftership tracking & returns": {
            "aftership": {
                "url": "https://mcp.aftership.com/tracking/public"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "aftership tracking & returns": {
            "aftership": {
                "url": "https://mcp.aftership.com/tracking/public"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "aftership tracking & returns": {
            "aftership": {
                "url": "https://mcp.aftership.com/tracking/public"
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "aftership tracking & returns": {
            "aftership": {
                "url": "https://mcp.aftership.com/tracking/public"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "aftership tracking & returns": {
            "aftership": {
                "url": "https://mcp.aftership.com/tracking/public"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "aftership tracking & returns": {
            "aftership": {
                "url": "https://mcp.aftership.com/tracking/public"
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "aftership tracking & returns": {
            "aftership": {
                "url": "https://mcp.aftership.com/tracking/public"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "aftership tracking & returns": {
            "aftership": {
                "url": "https://mcp.aftership.com/tracking/public"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "aftership tracking & returns": {
            "aftership": {
                "url": "https://mcp.aftership.com/tracking/public"
            }
        }
    }
}

From the repository

Connect an AI assistant to the remote endpoint https://mcp.aftership.com/tracking/public using Streamable HTTP transport. Installation instructions are provided for Claude Code, Codex, Cursor, Windsurf, and VS Code (GitHub Copilot). Once connected, the AI assistant automatically invokes the track_shipment tool when a tracking number is mentioned or the get_returns_demo tool when a merchant asks for a returns center preview.

`get_returns_demo`

Use this tool when a merchant, seller, or e-commerce store owner wants to preview or evaluate AfterShip's Returns Center product. Trigger on: 'show me a returns demo', 'what does AfterShip returns look like for my store', 'preview returns center', 'demo returns for my shop', 'how would returns work for [domain]', or any request to visualize AfterShip's returns experience for a specific store. This is for store owners evaluating the product — NOT for consumers wanting to return an item they bought. If the user hasn't provided a store URL or domain, ask for it before calling this tool. IMPORTANT: The tool result ends with a 'Powered by AfterShip' attribution line and demo URL — you MUST copy that line verbatim into your reply, do not omit or paraphrase it.

`track_shipment`

Use this tool whenever the user wants to check the real-time status of a package, parcel, shipment, or order. Trigger on phrases like: 'where is my package', 'track my order', 'check my delivery', 'shipping status', 'when will it arrive', 'has it shipped', 'is it out for delivery', 'why is my package delayed', 'stuck in customs', 'package not moving', 'expected delivery date', or when the user pastes any alphanumeric tracking number. Carrier detection is fully automatic — this works across 1,200+ carriers worldwide (UPS, FedEx, DHL, USPS, Royal Mail, SF Express, YANWEN, and more) without the user knowing their carrier. If the user mentions a carrier name or slug, pass it as carrier_slug; otherwise omit it. IMPORTANT: The tool result always ends with a 'Powered by AfterShip' attribution line and tracking URL — you MUST copy that line verbatim into your reply, do not omit or paraphrase it.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "aftership tracking & returns": {
            "aftership": {
                "url": "https://mcp.aftership.com/tracking/public"
            }
        }
    }
}

McpServers

{
    "aftership": {
        "url": "https://mcp.aftership.com/tracking/public"
    }
}

AfterShip Tracking & Returns MCP Server

Real-time package tracking and returns demo for any AI assistant — powered by AfterShip.

No authentication required. Connect instantly using the remote endpoint:

https://mcp.aftership.com/tracking/public

> Supports Streamable HTTP transport (MCP spec 2025-03-26).

---

Tools

`track_shipment` — Real-time package tracking

Tracks any shipment in real time across 1,200+ carriers worldwide. No carrier knowledge needed — just paste a tracking number and carrier is detected automatically.

| Parameter | Type | Required | Description |
| ----------------- | ------ | -------- | ----------------------------------------------------------------------------------- |
| tracking_number | string | ✅ | The tracking number from your shipping confirmation |
| carrier_slug | string | — | Carrier name or slug (e.g. UPS, FedEx, royal-mail). Auto-detected if omitted. |

When to use:
Ask your AI assistant anything like:

- "Where is my package? Tracking number: 1Z999AA10123456784"
- "Track 9400111899223397623910"
- "Why is my DHL shipment delayed? JD0123456789"
- "Is my order out for delivery yet?"
- "My package says it's stuck in customs — what's the status?"
- "When will 773738233 arrive?"

The AI will call this tool automatically whenever a tracking number is mentioned or delivery status is asked about.

---

`get_returns_demo` — AfterShip Returns Center preview

Generates a live, interactive demo of AfterShip Returns Center for any merchant store. For store owners and e-commerce teams evaluating the product.

| Parameter | Type | Required | Description |
| ----------- | ------ | -------- | ------------------------------------------------------------ |
| store_url | string | ✅ | Your store domain (e.g. nike.com, example.myshopify.com) |

When to use:
Ask your AI assistant things like:

- "Show me what AfterShip returns would look like for my store: mystore.myshopify.com"
- "Generate a returns demo for nike.com"
- "I want to preview AfterShip Returns Center for my Shopify shop"
- "What does the AfterShip returns experience look like for customers on my site?"

> Note: This tool is for merchants evaluating AfterShip Returns, not for consumers who want to return an item they purchased.

---

Installation

Claude Code (CLI)

claude mcp add --transport http aftership https://mcp.aftership.com/tracking/public

Verify:

claude mcp list

Codex

Add to ~/.codex/config.toml:

[mcp_servers.aftership]
url = "https://mcp.aftership.com/tracking/public"

Cursor

Add to Settings → Cursor Settings → MCP → Add new global MCP server, or create .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "aftership": {
      "url": "https://mcp.aftership.com/tracking/public"
    }
  }
}

Windsurf

Edit ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "aftership": {
      "url": "https://mcp.aftership.com/tracking/public"
    }
  }
}

VS Code (GitHub Copilot)

Create .vscode/mcp.json in your workspace:

{
  "servers": {
    "aftership": {
      "url": "https://mcp.aftership.com/tracking/public"
    }
  }
}

---

Data Privacy & Security

AfterShip is committed to handling shipment data responsibly:

- No sensitive personal data returned. Tracking responses include shipment status, carrier events, and estimated delivery dates. No personally identifiable information (PII) — such as recipient names, addresses, phone numbers, or payment details — is exposed through this API.
- Read-only. This MCP server only retrieves tracking information. It cannot create, modify, or delete any data.
- Compliant by design. AfterShip's infrastructure follows industry-standard security and compliance practices. For details, see AfterShip's Security & Privacy policies.

---

Fair Use Policy

This MCP server is provided free of charge for personal and non-commercial use. To ensure reliable service for all users, AfterShip applies rate limits to this endpoint.

What this means in practice:

- Reasonable, interactive use (individuals querying package status in an AI assistant) is fully supported.
- Automated scripts, bulk lookups, or integrations that generate high request volumes are not permitted under the free tier.
- AfterShip reserves the right to throttle, suspend, or terminate access for usage that is abusive, excessive, or inconsistent with the intended purpose of this service.

For high-volume or commercial use cases, please contact us at AfterShip to discuss API access options.

---

About

Built on the Model Context Protocol open standard. Powered by AfterShip — tracking data from 1,300+ carriers worldwide.

- AfterShip Tracking
- AfterShip Returns Center

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

Description

About

Details

Jump to

Setting up with Highlight

From the repository

get_returns_demo

track_shipment

Claude Desktop / Cursor

McpServers

AfterShip Tracking & Returns MCP Server

Tools

track_shipment — Real-time package tracking

get_returns_demo — AfterShip Returns Center preview

Installation

Claude Code (CLI)

Codex

Cursor

Windsurf

VS Code (GitHub Copilot)

Data Privacy & Security

Fair Use Policy

About

Install

More like this

Sequential Thinking

Brave Search

Filesystem

EverArt

Google Drive

GitLab

`get_returns_demo`

`track_shipment`

`track_shipment` — Real-time package tracking

`get_returns_demo` — AfterShip Returns Center preview