Reference Python SDK for the MCP Spatial Asset Profile v2 — JSON envelope for 3D / spatial assets in Model Context Protocol tool ecosystems.
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"mcp-spatial-asset-profile","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# mcp-spatial-asset-profile — Python SDK Reference Python SDK for the **[MCP Spatial Asset Profile v2](https://github.com/furuse-kazufumi/mcp-spatial-asset-profile)** — a JSON envelope format for 3D / spatial assets in Model Context Protocol (MCP) tool ecosystems. - **Distribution name (PyPI):** [`mcp-spatial-asset-profile`](https://pypi.org/project/mcp-spatial-asset-profile/) - **Import package:** `spatial_asset_v2` - **TypeScript counterpart:** [`@furuse-kazufumi/mcp-spatial-asset-profile`](https://www.npmjs.com/package/@furuse-kazufumi/mcp-spatial-asset-profile) - **Spec & repository:** <https://github.com/furuse-kazufumi/mcp-spatial-asset-profile> - **Release tag:** [`v0.1.0-poc`](https://github.com/furuse-kazufumi/mcp-spatial-asset-profile/releases/tag/v0.1.0-poc) > **Status — Proof of Concept.** The format is usable for prototyping and interoperability experiments. The wire format is not yet frozen; feedback via [GitHub Discussions](https://github.com/furuse-kazufumi/mcp-spatial-asset-profile/discussions) is explicitly welcome before v2.1. ## Installation Once published to PyPI: ```bash pip install mcp-spatial-asset-profile # Optional: enable JSON Schema validation pip install "mcp-spatial-asset-profile[validate]" ``` From source (this repository): ```bash cd sdk/python pip install -e ".[dev]" ``` ## Quick Start ```python from spatial_asset_v2.models import SpatialAsset, Representation, Spatial from spatial_asset_v2.codec import encode_asset, decode_asset from spatial_asset_v2.validators import validate_asset from spatial_asset_v2.workflow import WorkflowMockRunner # Create a v2 asset asset = SpatialAsset( asset_id="urn:uuid:550e8400-e29b-41d4-a716-446655440001", kind="point-cloud", representations=[ Representation(format="ply", uri="samples/bunny.ply", point_count=35947) ], spatial=Spatial(unit="m", up_axis="+Y"), name="Stanford Bunny", ) # Encode to dict / JSON d = encode_asset(asset) # Decode from dict asset2 = …
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.