Skip to main content
Glama
NOVA-3951

Parcel MCP Server

by NOVA-3951

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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

No tool schema history has been recorded yet.

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • 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
    6
    MIT
  • 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
    GPL 3.0
  • 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
    6
    MIT

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/NOVA-3951/Parcel-API-MCP'

If you have feedback or need assistance with the MCP directory API, please join our Discord server