Skip to main content
Glama

Trackkr MCP Server — Smart Lockerless Parcel Management

A Model Context Protocol server that enables AI agents to autonomously manage incoming packages, log parcels, cross-reference unit directories, and track pick-up signatures without physical locker hardware.


Capabilities / Tools List

  • get_pending_parcels: Fetches the current ledger of uncollected packages, highlights aging stats (5+ days), and returns structured JSON context.

  • log_incoming_parcel: Accepts parsed text from Google Cloud Vision OCR label scans and/or external photoUrl links (automatically downloaded and hosted on Firebase Storage), cross-references internal Firestore unit listings, and schedules automated email alerts via SendGrid and US (+1) SMS alerts via the Quo Phone API.

  • release_parcel_with_signature: Updates parcel state to Picked Up, records the timestamp, and securely saves the digital signature PNG layout to Firebase Storage.


Related MCP server: Property MCP Server

Configuration & Environment Variables

Variable

Required

Description

FIREBASE_CONFIG_JSON

Yes

Path to your authorized Firebase service account credentials (or stringified JSON).

USE_MOCK_OCR

No

Set to true during local staging to bypass paid Google Cloud Vision API billing counters.


Quickstart Guide

Run via npx

FIREBASE_CONFIG_JSON="./service-account.json" \
USE_MOCK_OCR="true" \
npx -y github:DTLA-Professional-Services-LLC/trackkr-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "trackkr-mcp": {
      "command": "npx",
      "args": ["-y", "github:DTLA-Professional-Services-LLC/trackkr-mcp"],
      "env": {
        "FIREBASE_CONFIG_JSON": "/path/to/service-account.json",
        "USE_MOCK_OCR": "true"
      }
    }
  }
}

Available Tools

3 tools
get_pending_parcelsB

Fetches the current ledger of uncollected packages, highlights aging stats (5+ days), enriches each with occupant contact preferences and notification/telemetry history, and returns structured JSON context.

Inputs: businessId, maxResults, emitTelemetry, thresholdDays.

log_incoming_parcelB

Accepts parsed text from Google Cloud Vision OCR label scans and/or a trusted Firebase Storage photoUrl, cross-references internal Firestore unit listings, enforces a 4-hour idempotent lock on (trackingNumber + unitId), and schedules automated email alerts via SendGrid.

Inputs: businessId (required), qty, notes, unitId, +9 more.

release_parcel_with_signatureB

Updates parcel state to Picked Up, records the pickup timestamp and recipient name, securely saves the digital signature PNG layout to Firebase Storage, and emits a PARCEL_RELEASED telemetry event.

Inputs: parcelId (required), businessId (required), pickedUpBy (required), datePickedUp, +4 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool targets a distinct parcel lifecycle stage: viewing pending parcels, logging incoming parcels, and releasing parcels with signature. There is no meaningful overlap in purpose or resource, so an agent can easily select the right tool.

    Naming Consistency5/5

    All tool names use snake_case with a leading verb and a parcel-related noun (get_pending_parcels, log_incoming_parcel, release_parcel_with_signature). The pattern is predictable, and the third tool's modifier does not disrupt readability.

    Tool Count4/5

    Three tools is lean but reasonable for a focused intake-to-release workflow. It is slightly under-scoped for a parcel-tracking domain that likely benefits from additional query and update operations.

    Completeness3/5

    The core lifecycle is covered: log incoming, list pending, and release with signature. However, there are notable gaps such as getting a parcel by ID, listing full history/all parcels, updating parcel details, canceling/deleting, and managing notifications or units.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI agents to manage global shipping operations, including rate comparison, shipment creation, label purchasing, tracking, pickup scheduling, address validation, billing, and analytics, via natural language.
      32 npm
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to operate property management systems via natural language, covering repair orders, owner info, payments, notices, and inspections. Features a full agentic workflow with human-in-the-loop and observability.
      1
      MIT
    • 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