{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_pjbtr7gy7ks5","handle":"parcelapp-mcp","url":"https://wellknown.network/agents/parcelapp-mcp","links":{"self":"https://wellknown.network/agents/parcelapp-mcp/record.json","html":"https://wellknown.network/agents/parcelapp-mcp","markdown":"https://wellknown.network/agents/parcelapp-mcp/record.md","api":"https://wellknown.network/api/v1/agents/parcelapp-mcp","status":"https://wellknown.network/api/v1/agents/parcelapp-mcp/status","claim":"https://wellknown.network/agents/parcelapp-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/parcelapp-mcp/claim.json","badge":"https://wellknown.network/agents/parcelapp-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/parcelapp-mcp/history","tools":"https://wellknown.network/api/v1/agents/parcelapp-mcp/tools"},"ard":{"identifier":"urn:air::server:parcelapp-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"parcelapp-mcp","summary":"MCP server for the Parcel delivery tracking app: read and add deliveries over stdio or HTTP","description":"# parcelapp-mcp\n\n![Python](https://img.shields.io/badge/Python-3.10+-blue?logo=python&logoColor=white)\n![PyPI](https://img.shields.io/pypi/v/parcelapp-mcp?logo=pypi&logoColor=white)\n![CI](https://github.com/obeone/parcelapp-mcp/actions/workflows/ci.yml/badge.svg)\n![Docker](https://img.shields.io/badge/Docker-Ready-blue?logo=docker&logoColor=white)\n![License](https://img.shields.io/badge/License-MIT-green)\n\nAn MCP server for [Parcel](https://parcelapp.net), the iOS/macOS delivery\ntracking app. It wraps Parcel's external API (a premium feature of the app)\nso an LLM client can list your deliveries, add new ones to track, and look up\ncarrier codes, over either stdio or streamable HTTP.\n\nThis project is not affiliated with or endorsed by Parcel.\n\n## 🚀 Features\n\n| | Feature | Notes |\n| --- | --- | --- |\n| 📦 | List deliveries | Recent or active, with filtering and sorting, served from a 3-minute cache |\n| ➕ | Add a delivery | Validated locally first, so a typo never spends part of the daily quota |\n| 🔍 | Search carriers | Free, unrated lookup from code or name to the internal carrier code |\n| 📡 | Resource template | `parcel://deliveries/{filter_mode}` for passive reads alongside the tools |\n| 🔐 | Two auth modes | Environment variable over stdio, per-request header over HTTP |\n| 🚦 | Rate-limit awareness | Every result reports an honest, locally-tracked budget estimate |\n| 🐳 | Container-ready | Ships a Dockerfile for the HTTP transport, no key baked in |\n\n## ⚡ Quickstart\n\nRun it directly with [uv](https://docs.astral.sh/uv/), no install step:\n\n```bash\nPARCEL_TOKEN=your-parcel-api-key uvx parcelapp-mcp\n```\n\nGet a key at <https://web.parcelapp.net> (requires a Parcel premium\nsubscription). Pin a version with `uvx parcelapp-mcp@0.2.0`, or track the\nlatest release with `uvx parcelapp-mcp@latest`.\n\nTo wire it into an MCP client such as Claude Desktop, add:\n\n```json\n{\n  \"mcpServers\": {\n    \"parcel\": {\n      \"command\": \"uvx\",\n      \"args\": [\"parcelapp-mcp\"],\n      \"env\": { …","publisher":null,"homepage":"https://github.com/obeone/parcelapp-mcp","repository":"https://github.com/obeone/parcelapp-mcp","version":"0.2.1","license":null,"protocols":["mcp"],"tags":["claude","delivery-tracking","llm-tools","mcp","mcp-server","model-context-protocol","package-tracking","parcel","parcelapp","shipment-tracking"],"pricing":null,"endpoints":[{"url":"pypi:parcelapp-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":1,"provenance":"derived"}],"categories":["dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"parcelapp-mcp","registry":"pypi","observedAt":"2026-11-09T23:25:27.642Z","publishedAt":"2026-09-08T11:40:27.773361Z","latestVersion":"0.2.1"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"parcelapp-mcp","url":"https://pypi.org/project/parcelapp-mcp/","firstSeenAt":"2026-09-10T09:25:34.665Z","fetchedAt":"2026-11-09T23:24:29.348Z","normalizedAt":"2026-11-09T23:24:29.348Z"}]},"firstSeenAt":"2026-09-10T09:25:34.665Z","updatedAt":"2026-11-09T23:25:27.642Z"}