usps-epf-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| EPF_BASE_URL | No | Override for sandbox/test. | https://epf.usps.gov/up |
| EPF_PASSWORD | Yes | Required. Your EPF password. | |
| EPF_USERNAME | Yes | Required. Your EPF username. | |
| EPF_LOG_LEVEL | No | Log level: silent|info|debug. | info |
| EPF_TIMEOUT_MS | No | HTTP timeout per request. | 30000 |
| EPF_DOWNLOAD_DIR | No | Directory for downloaded files. `~` is expanded. | ~/epf/downloads |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| epf_versionA | Get the EPF server version and build date. No auth required. |
| epf_loginA | Authenticate with EPF using username/password. Pass store=true to make the resulting JWT the active session credential. |
| epf_logoutA | Call EPF /logout on the server, then clear the local session credential. Subsequent calls error until epf_reauth. |
| epf_reauthA | Re-authenticate with the credentials supplied at boot. Use after a 401 error or before a known-stale batch. |
| epf_acs_listB | List ACS-keyed download files scoped to productId=PARENT. Bearer auth required. Optionally filter by status (N=new, S=started, X=cancelled, C=completed). |
| epf_download_listA | List EPF download files scoped to productId=PARENT. Bearer auth required. Optionally filter by status (N=new, S=started, X=cancelled, C=completed). |
| epf_download_epf_fileA | Stream a binary EPF file to EPF_DOWNLOAD_DIR and return metadata only (path, content-type, byteLength, sha256). Bytes never enter the LLM context. |
| epf_update_statusB | Update file status. Bearer auth required. status: N=new, S=download started, X=cancelled, C=completed. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 8 tools
Most tools are clearly distinct: auth lifecycle (login/logout/reauth/version) vs. file operations (list/download/update). The two list tools (epf_acs_list and epf_download_list) are similar but differ by ACS vs. EPF file type, and descriptions clarify the distinction.
All tools use the epf_ prefix with verb_noun naming (epf_login, epf_acs_list, epf_download_epf_file). Minor inconsistency: epf_acs_list and epf_download_list use noun_verb order (acs_list, download_list) while epf_download_epf_file uses verb_noun, but the pattern is still predictable.
8 tools is well-scoped for an EPF/ACS file download server: 4 auth/version tools and 4 file operation tools. Each tool serves a clear purpose without redundancy.
The tool set covers the full auth lifecycle (login, logout, reauth) and the core file workflow (list, download, update status). Minor gap: no explicit tool to get a single file's details without downloading, but the list tools provide status filtering and metadata.