We count page visits with Google Analytics to see which pages are read. Nothing is stored until you accept, and we never store search queries. Privacy.
Every change Wellknown observed on this MCP server, newest first, with what it was before and what it became. Tool-surface changes carry the definition diff. Nothing here is edited after the fact.
Changed the definition of "download_asset" and "get_item"
download_assetchanged
description
⟨38 unchanged words⟩ without
downloading, then again with ``confirm=True`` to actuallyfetchfetch.it.ReturnsOn alocal or stdio server, ``confirm=True`` returns ``{asset, path, bytes}`` on download,``.
``confirm=False``orreturns a size-and-hint object when
confirmationandisdoesstillnotrequired.write a file.
On a public host (``umbra serve --public``, COG streaming off),
``confirm=True`` isdoesrefused.notThetransfererror
get_itemchanged
description
⟨215 unchanged words⟩ local open-data index when a token is set.
On the public host a URL is fetched only when it is https on Umbra's
public open-data bucket. Any other URL is refused before a request.
A bare id that is not in the local index is refused the same way.
The card (:meth:`UmbraItem.to_llm_context`) carries the id ⟨31 unchanged words⟩
41 words differ · removed · added
Status
Unknown → Live
Tool surface
First tool surface recorded: 19 tools (server version 0.1.4)
Endpoint
https://api.umbra-py.space/mcp (mcp_streamable_http) — from mcp_registry
It returns a link plan:
``mode`` ``"link"``, ``downloaded`` false, ``asset``, ``filename`` (a
basename),
the
asset
direct
public ``href``, ``bytes``, and ``how_to_fetch``.
When the
href
is https on the public open-data bucket, ``how_to_fetch``
is ``curl -L -C - -o <filename> <href>``
and
``umbra
its
download ITEM --asset ASSET --dest DIR``. ``bytes`` is the STAC
size
``file:size``
in
or
bytes
``size``
when that is a non-negative integer; otherwise
the host HEADs that href for ``Content-Length``, with no redirects
and
no
tells
retries.
you
A
to
href
download
that
is not on that bucket is not requested:
``how_to_fetch.curl`` and ``how_to_fetch.umbra`` are null, ``bytes`` is
null, and ``note`` says
the
file
commands
locally
were
(
omitted. A 404
or
run
410
from
an allowlisted HEAD raises. Any other HEAD failure, including
a
full
quick-request slot, leaves ``bytes`` null and still returns the plan.
The hosted server never transfers the file. A
local
``uvx --from 'umbra-py[mcp]' umbra-mcp`` server
for
downloads
``download_asset``).
to your own
disk.
``confirm=False``
still
on
this host
returns the
size.
same size-and-hint
object and does not write a file. It HEADs for ``Content-Length`` only
when the href is https on the public open-data bucket, with no retries,
and it does not follow redirects. A 404 or 410 raises, and so does any
other non-redirect HEAD error. A redirect leaves ``bytes`` null. A href
outside the bucket is not requested; ``bytes`` is the STAC ``file:size``
or ``size`` when that is a non-negative integer, otherwise null. A local
server still HEADs the href and follows redirects.