Poobah MCP
Tool Reference
VFS Operations

VFS Operations

Tools for the Virtual Filesystem - Andromeda's human-readable path system for contracts.

Note: VFS tools support the optional userId parameter for session persistence. Include it in every call to maintain chain state across reconnections.

resolve_path

Resolve a VFS (Virtual Filesystem) path to a blockchain address.

Parameters

ParameterTypeRequiredDescription
pathstringYesThe VFS path to resolve

VFS Path Format

VFS paths follow a familiar filesystem structure:

/home/username/contract-name

Example

{
  "path": "/home/alice/my-nft-collection"
}

Response

Returns the blockchain address that the path resolves to.

Why Use VFS?

Instead of remembering long blockchain addresses like:

andr14hj2tavq8fpesdwxxcu44rty3hh90vhujrvcmstl4zr3txmfvw9shptkql

You can use human-readable paths:

/home/alice/my-nft-collection

Path Structure

  • /home/username/ - User's registered contracts
  • Paths are registered when creating ADOs through the kernel
  • Each path maps to exactly one contract address
Environment OperationsService Operations