eagle1-whereis-mcp
适用于 DeepSeek Harness 的 Whereis 货件跟踪：连接 Eagle1 Whereis MCP 服务器，使代理能够查询最新货件状态，并在提供密钥后查询完整跟踪历史。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:eagle1-sys/eagle1-whereis-mcp#d535071ef309faa5f868f01f1abd3db3caa3943bEagle1 Whereis Mcp 以 eagle1-whereis-mcp 发布，当前版本为 1.0.2。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
A configuration-only DSH bundle that connects the Eagle1 Whereis MCP server. Once installed, the agent can list carriers, read the latest shipment status, and — with an API key — retrieve full tracking history.
| Tool | What it does | API key |
|---|---|---|
mcp__whereis__list_operators | Resolve fdx / sfex / eg1 carrier codes | No |
mcp__whereis__get_latest_status | Current status, location, and last scan | No |
mcp__whereis__track_shipment | Full event timeline and delivery proof | Yes |
Plus the whereis://reference/status-codes resource.
The bundle points at the hosted endpoint:
https://api.eg1.io/mcp
No API key is needed for the connection itself. Anonymous users get
list_operators and get_latest_status; a key unlocks track_shipment.
>= 0.2.1-rc.5https://api.eg1.io/mcpplugin_manager
action: install_bundle
target: git+https://github.com/eagle1-sys/eagle1-whereis-mcp.git#v1.0.2
Pin the tag for a stable version, or replace v1.0.2 with a full commit SHA
for an immutable install. If you previously installed a local
@local/whereis-mcp, remove it first so the whereis-mcp row is not duplicated.
Open Plugins, choose Install, and enter:
eagle1-whereis-mcp
or a pinned version:
eagle1-whereis-mcp@1.0.2
plugin_manager
action: install_bundle
target: eagle1-whereis-mcp@1.0.2
After installation, the tools appear as mcp__whereis__*.
| Capability | No key | With key |
|---|---|---|
list_operators | Yes | Yes |
get_latest_status | Yes | Yes |
track_shipment | No | Yes |
refresh=true carrier pull | No | Yes |
If anonymous MCP connections are not enabled on the deployment, no-key users can still call the public status endpoint directly:
curl "https://api.eg1.io/v0/status/fdx-879448793247"
To unlock full history, add a higher-priority override to your profile's
cordis.patch.yml (or the equivalent profile patch) that restates the whole
row:
- id: whereis-mcp
name: '@deepseek-ai/dsh-mcp-client'
config:
serverName: whereis
transport: streamable-http
url: https://api.eg1.io/mcp
headers:
Authorization: !!js '`Bearer ${process.env.WHEREIS_API_KEY}`'
toolCallTimeoutMs: 120000
failOnStartupError: true
Set WHEREIS_API_KEY in the environment that launches DeepSeek Harness. The
!!js expression is evaluated in the Harness process, not in the conversation,
so the key does not appear in chat. If your client cannot use !!js, put a
local-only literal in the profile patch instead and keep that file out of
version control.
Do not put keys in this package, in cordis.patch.yml inside the bundle, or in
a message.
What carriers does Whereis support?
Where is fdx-879448793247?
Track these FedEx numbers and tell me if anything is delayed:
879512749003, 879512676449, 879248502068.
Track sfex-SF1234123412341 with phone 6993.
For SF Express, include the last four digits of the recipient's phone. Tracking
IDs are <operator>-<tracking_number>.
| Symptom | Fix |
|---|---|
| Tools do not appear | Check that the bundle is installed and selected; check the MCP connection error in Plugins |
401-01 / 401-02 | No key or a bad key. Status-only works without one; add a key only for history |
403-01 | The key is restricted; use a full key |
404-01 | The carrier has no data; verify the number or note retention limits |
| Connection fails at startup | Confirm https://api.eg1.io/mcp is live and reachable |
| HTTP 403 from a self-hosted endpoint | Check MCP_ALLOWED_HOSTS / connect from an allowed host |
The agent sends only tracking IDs and, for SF Express, the last four phone digits to the API. It should not send names, addresses, or other personal data. The package contains no credentials and no tracking data.
Remove eagle1-whereis-mcp from the Plugins page, or:
plugin_manager
action: remove_bundle
target: eagle1-whereis-mcp
BSD-3-Clause. The icon is the EG1 logo from whereis.eagl.io, used with permission; see ICON.md.