Skip to main content
Glama
NOVA-3951

Parcel MCP Server

by NOVA-3951
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

Parcel MCP Server

An HTTP MCP (Model Context Protocol) server for the Parcel delivery tracking API, hosted on Replit and secured with OAuth 2.1 backed by Clerk. Only users who sign in can obtain a token and use the tools.

Features

Tools

  1. add_delivery — Add a new delivery to Parcel for tracking

    • tracking_number (required), carrier_code (required), description (required)

    • language (optional, ISO 639-1), send_push_confirmation (optional)

    • Rate limit: 20 requests per day

  2. get_deliveries — Get recent or active deliveries

    • filter_mode (optional): active or recent (default)

    • Rate limit: 20 requests per hour

  3. get_supported_carriers — List supported carriers and their codes

  4. get_delivery_status_codes — Explain delivery status codes (0-8)

Related MCP server: Parcel App MCP Server

How access control works

The server implements the MCP authorization spec (OAuth 2.1):

  • POST /mcp — the MCP endpoint (Streamable HTTP transport). Requires a bearer token; unauthenticated requests get a 401 with a WWW-Authenticate challenge pointing at the discovery metadata.

  • /.well-known/oauth-authorization-server and /.well-known/oauth-protected-resource/mcp — discovery metadata so clients can auto-configure.

  • /register — dynamic client registration.

  • /authorize — sends the user through Clerk sign-in and a consent step before issuing an authorization code (PKCE required).

  • /token — exchanges codes/refresh tokens for bearer tokens bound to the authenticated user.

  • /revoke — token revocation.

Tokens are held in memory: a server restart just means MCP clients transparently re-authenticate.

Connecting from an MCP client

Add the server URL to any MCP client that supports OAuth (Claude, Cursor, etc.):

https://<your-repl-domain>/mcp

On first connection a browser window opens and asks you to sign in and approve access. After consent, the client receives a token and the tools become available.

Configuration

Variable

Purpose

PARCEL_API_KEY

Server-side Parcel API key (from web.parcelapp.net). Never exposed to clients.

CLERK_SECRET_KEY

Auto-provisioned by Clerk setup.

CLERK_PUBLISHABLE_KEY

Auto-provisioned by Clerk setup.

ALLOWED_REPLIT_USERS

Optional. Comma-separated user IDs or emails allowed to connect. When unset, any authenticated user may connect. For users migrated from Replit Auth, their original Replit user ID is preserved as the Clerk external ID.

All are managed as Replit Secrets.

Development

npm install
npm start   # builds and runs on port 5000

Resources

License

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Parcel Tracking MCP Server

    iamfiro
    A
    license
    B
    quality
    D
    maintenance
    Allows tracking of parcel deliveries across various carriers using the 17track.net API, with automatic or manual carrier detection.
    2
    21 npm
    6
    MIT

  • Parcel App MCP Server

    as-j
    A
    license
    Not graded
    quality
    C
    maintenance
    Enables users to manage package deliveries through the Parcel.app tracking API. It allows AI clients to list active or recent deliveries and add new packages directly to a Parcel account using tracking numbers and carrier codes.
    21 npm
    GPL 3.0

  • Parcel MCP Server

    oliverames
    A
    license
    A
    quality
    A
    maintenance
    Enables delivery tracking through the Parcel API, including listing and fetching deliveries, searching carriers, and adding new deliveries with optional write protection and multiple credential methods.
    5
    0
    MIT

  • UPS MCP Server

    VoxveyAI
    A
    license
    Not graded
    quality
    C
    maintenance
    Enables AI agents to track packages, rate and create shipments, manage pickups and customs documentation, and perform international shipping logistics checks through natural language.
    MIT