Borrowing it
Nothing to install: this file belongs to putervision/state-memory-mcp. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.
curl -O https://raw.githubusercontent.com/putervision/state-memory-mcp/main/.agents/skills/world-model-mcp/SKILL.mdgit clone --depth 1 https://github.com/putervision/state-memory-mcpWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/putervision/state-memory-mcp/world-model-mcp)<a href="https://agentmods.dev/skills/putervision/state-memory-mcp/world-model-mcp"><img src="https://agentmods.dev/badge/skills/putervision/state-memory-mcp/world-model-mcp/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/putervision/state-memory-mcp/world-model-mcp"><img src="https://agentmods.dev/badge/skills/putervision/state-memory-mcp/world-model-mcp.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00039 | $0.00742 |
| Opus 5.5 | $0.00016 | $0.00297 |
| Sonnet 5.5 | $0.00008 | $0.00148 |
| Haiku 4.5 | $0.00004 | $0.00074 |
Grade A, and why
world-model-mcp scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 47 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Spatial World Model (world-model-mcp)
This skill provides step-by-step guidance and operational patterns for interacting with @putervision/world-model-mcp.
1. Role in the PuterVision Triad
- Perception Layer (
vision-memory-mcp): Ingests images, detects bounding boxes, extracts OCR. - World Model Layer (
world-model-mcp): Maintains persistent 3D/2D coordinates, bounding volumes, topological relations, and object permanence. - Action/State Layer (
state-memory-mcp): Manages task execution DAGs, decisions, blockers, and milestones.
2. Core Operational Sequence
- Inspect World: Call
get_spatial_mapwithformat: 'summary'to check total entities and spatial bounding box. - Proximity Lookup: Call
query_entitieswithnear_positionandmax_distance, orentity_idfor direct lookup. - Ingest Perception: When new visual elements are detected, call
ingest_observation. - Collision Pre-Check: Call
simulate_movementbefore issuing action commands. - Update State: Call
record_outcomeafter actions complete.
3. Tool Reference (15 Tools)
| Tool Name | Key Inputs | Description |
|---|---|---|
update_entity |
name, type, position, bounding_box, properties | Upsert entity into spatial memory |
query_entities |
query, type, near_position, entity_id, include_history | Find entities by text search, proximity, or entity ID |
set_relation |
source_id, relation, target_id, offset | Record spatial relationship (on, inside, near, etc.) |
get_spatial_map |
region_id, format (json, gltf, obj, summary) | Export structured spatial layout or summary |
simulate_movement |
entity_id, delta_position, mode, check_collisions | Predict movement path or compute navigation waypoints |
ingest_observation |
observer_pose, detections, visual_state_id, reconcile | Ingest perception detections and reconcile frustum view |
get_expected_view |
observer_position, observer_orientation, fov | Calculate visible entities from observer pose |
link_to_goal |
task_id, entity_id, relationship, action | Associate entity with task or extract spatial slice |
record_outcome |
action_name, success, resulting_position | Update world state after action completion |
manage_spatial_spec |
action, name, bounds, constraints | Spatial SDD contract registration and verification |
create_evidence_pack |
task_id, entity_ids, snapshot_ids | Immutable cryptographic evidence package |
use_spatial_blackboard |
action, topic, sender, payload | Multi-agent coordination and mutex locks |
manage_snapshot |
action, name, snapshot_a, snapshot_b, entity_id | Snapshots, diffs, undo mutations, and time-travel |
generate_game_inputs |
entity_id, target_position, control_profile, action | Playwright game inputs and screen coordinate projection |
wait_for_spatial_state |
entity_id, condition, threshold, timeout_ms | Polling and waiting for spatial state condition |
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 1mo ago First seen · 47 lines · 39 tokens per session scan A 2527537a185c
world-model-mcp is a skill published in the GitHub repository putervision/state-memory-mcp (42 stars, last pushed 1mo ago), licensed MIT. It adds 39 tokens to every session and 742 once invoked, about $0.0002 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-11.
world-model-mcp compared with skills from other repositories
| Mod | Type | Stars | Last push | Licence | Scan | Tokens | Works with |
|---|---|---|---|---|---|---|---|
| world-model-mcpputervision/state-memory-mcp | Skill | 42 | 1mo ago | MIT | A | 39 | Claude Code, Codex |
| opik-diagnosecomet-ml/opik-mcp | Skill | 225 | 9d ago | Apache-2.0 | A | 187 | Claude Code |
| cortex-explore-memorycdeust/Cortex | Skill | 76 | today | MIT | A | 91 | Claude Code |
| qmclaw-workbenchxi-zhao/OpenQuantum | Skill | 71 | today | MIT | A | 124 | Codex |
| quantum-groverxi-zhao/OpenQuantum | Skill | 71 | today | MIT | A | 62 | Claude Code, Codex |
| quantum-algorithmsxi-zhao/OpenQuantum | Skill | 71 | today | MIT | A | 34 | Claude Code, Codex |
| alicebob-cat-circuitsxi-zhao/OpenQuantum | Skill | 71 | today | MIT | A | 51 | Claude Code, Codex |