Skip to main content

undisk-mcp

Python SDK for Undisk MCP — undo-first versioned file storage for AI agents.

Install

pip install undisk-mcp

Quick Start

import asyncio
from undisk_mcp import UndiskClient

async def main():
    async with UndiskClient(api_key="your-api-key") as client:
        await client.initialize()

        # Write a file
        await client.write_file("hello.txt", "Hello from Python!")

        # Read it back
        result = await client.read_file("hello.txt")
        print(result.text)

        # List all files
        files = await client.list_files()
        print(files.text)

asyncio.run(main())

Features

  • Typed client with convenience methods for common MCP tools
  • Session management (automatic Mcp-Session-Id tracking)
  • Retry with exponential backoff (configurable)
  • Async-first design using httpx
  • Context manager support (async with)

API Reference

UndiskClient

client = UndiskClient(
    api_key="your-key",
    endpoint="https://mcp.undisk.app",  # default
    max_retries=3,                       # default
    timeout=60.0,                        # default
)

Methods

Method Description
initialize() Initialize MCP session
call_tool(name, args) Call any MCP tool by name
read_file(path) Read a file
write_file(path, content) Write a file
create_file(path, content) Create a new file (fails if exists)
list_files(path) List files
delete_file(path) Delete a file
move_file(from_path, to_path) Move or rename a file
search_files(pattern) Search file contents
list_versions(path) Get version history
restore_version(path, version_id) Restore a version
get_diff(path, from_version, to_version) Compare two versions
append_log(path, content) Append to a log file
close() Close the client

License

MIT

Metadata

Release files for undisk-mcp 0.54.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for undisk-mcp 0.54.1
File Size Uploaded Provenance Actions
undisk_mcp-0.54.1.tar.gz 14.0 kB Without provenance Details for undisk_mcp-0.54.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for undisk-mcp 0.54.1
File Interpreter ABI Platform Actions
undisk_mcp-0.54.1-py3-none-any.whl Python 3 none any Details for undisk_mcp-0.54.1-py3-none-any.whl

Total release size: 26.2 kB

Release files / undisk_mcp-0.54.1.tar.gz

Download URL undisk_mcp-0.54.1.tar.gz
Size 14.0 kB
Tags Source
SHA-256 checksum
How to use checksums
1dc22e23d9510b210852a3328099b006d4f82e7af8df01247dea65bdb7b4e292
BLAKE2b-256 checksum
How to use checksums
621526921964e243411fdc58f4485efd31e32160629db43b80d1742ce3cf9044
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.13

Release files / undisk_mcp-0.54.1-py3-none-any.whl

Download URL undisk_mcp-0.54.1-py3-none-any.whl
Size 12.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f225900f92d59ba97d1a50333476884a3ebacd08d6a55e855e9ff1081ffa81e0
BLAKE2b-256 checksum
How to use checksums
a1fc63c9df69095122ede7390ba3df34bbc9c9d42663d7df70e2f55bd8d93111
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.13

Security for undisk-mcp 0.54.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.54.1 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page