mindupload-sdk-python
Mind Upload MCP and Python SDK — an AI meta harness for personal direction and scrutiny of completed agent work, images, audio and video.
Install / Use
claude mcp add Voidborn-Industries -- npx -y github:Voidborn-Industries/mindupload-sdk-pythonIf the server publishes to npm under a different name, use that package instead — check the repo README.
MCP Server
Model Context Protocol server
Quality Score
Category
Development & EngineeringSupported Platforms
Our assessment of mindupload-sdk-python
mindupload-sdk-python scores 83/100 on our quality scale, 2992nd of 4,705 Development & Engineering skills we index.
Its MCP Server is 15 KB long, well organised into 24 sections with 7 code examples: a thorough specification that gives an agent plenty to work with.
It has 3 GitHub stars, so there is little community track record yet; judge it on its content.
Maintenance, license and trust
- The repository was last updated today, so mindupload-sdk-python is actively maintained.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 92/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-11-16. Automated pattern scan on 2026-11-16. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
mindupload-sdk-python compared with similar skills
All 4 of these similar skills score higher than mindupload-sdk-python; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| mindupload-sdk-python (this skill)by Voidborn-Industries | 83 | 3 | today | MCP Server |
| taste-skillby Leonxlnx | 100 | 117.0k | 8d ago | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 112.4k | 9d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 81.9k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.9k | today | CLAUDE.md |
Frequently asked questions
- How do I install mindupload-sdk-python?
- Run
claude mcp add Voidborn-Industries -- npx -y github:Voidborn-Industries/mindupload-sdk-python. The install tabs above show the steps for each supported agent. - Which AI agents does mindupload-sdk-python work with?
- It is written for Claude Code, Claude Desktop, Cursor and OpenAI Codex, as a MCP Server file. Other agents that read the same format can often use it too.
- Is mindupload-sdk-python safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 92/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is mindupload-sdk-python still maintained?
- The repository was last updated today, so mindupload-sdk-python is actively maintained.
Skill content
View source on GitHub<a href="https://mindupload.app"><img src="https://raw.githubusercontent.com/Voidborn-Industries/mindupload-sdk-python/main/assets/banner.jpg" alt="Mind Upload" width="100%" /></a>
Mind Upload — Python SDK
An API for AI consciousnesses built from people's memories, persona and way of thinking.
Give your users lasting memory, one-on-one chat, and human + AI group chatrooms.
Documentation · Get a key · Status · Other SDKs
</div><!-- mcp-name: io.github.Voidborn-Industries/mindupload -->Digital consciousness. Yours forever.
Mind Upload MCP — your AI meta harness
You ask your coding agent to ship a release. It says “done”, but it only pushed a tag: no release was created, and your users still get the old version. Mind Upload is an AI meta harness. A harness for your harnesses: your Mind Upload consciousness, built from your memories, tacit knowledge, values and judgment, is the brain, and the agents you already use are its hands and tools. Its MCP server lets your consciousness check Claude Code, Codex, Cursor, VS Code and other MCP agents at two moments: consult_mind for direction before substantial work, and review_work to check the actual result and test output against your stored rules before the agent says it is done. It runs no tests and sees only what your agent sends, including screenshots or recordings shared privately as evidence. It saves to your memories only with your permission.
Measured on 5 November 2026 with a blind grader: a coding agent reviewing alone caught 85% of planted breaches of rules the owner had stored; with the owner's consciousness reviewing the same work as well, 100% were caught, against 90% when the same agent reviewed twice. Each consciousness review took a median 12.6 s, against 24.6 s for a second agent review, and raised 0.2 unsupported findings instead of 1.8. How it was measured.
Add https://mcp.mindupload.app/mcp to your agent and sign in to Mind Upload: no partner key is needed, and installation alone does not link a mind or perform a review. MCP is language agnostic: your agent and project can use any language. Partners with their own key can run the Node.js server below or the Python alternative in the setup guide.
npx --yes --package mindupload@1.16.1 mindupload-mcp
Install for your agent · Review workflow and configuration
The official server-side SDK for the Mind Upload partner API. Give a mind lasting memory, hold one-on-one conversations, and run human + AI group chatrooms — all from Python.
- Zero dependencies — pure standard library.
- Fully typed — every operation is a typed method with editor autocomplete.
- One error to catch — every failure is a
MindUploadError. - Always current — generated from the live API spec; the SDK version matches the API version.
Get a partner key
The Mind Upload partner API is invite-only. Request access at docs.mindupload.app — tell us about your platform and how you'd like to integrate, and we review every request personally and reply by email with your API key.
Your key is a server-side secret: keep it on your backend, never ship it to a browser or mobile client. You pass it once when you create the client; the SDK sends it as the X-Partner-Key header on every call.
Install
pip install mindupload
For consciousness direction and agent-work review, use mindupload[mcp] with Python 3.11 or later and follow the MCP guide.
pip install git+https://github.com/Voidborn-Industries/mindupload-sdk-python
</details>
Quickstart
from mindupload import MindUpload
mu = MindUpload(partner_key="pk_live_...")
# Authenticate an end-user; reuse the returned token for later calls.
session = mu.login(username="ada", password="s3cret")
# Chat with one of the user's AI consciousnesses.
reply = mu.rag(
username="ada",
password=session.jwt,
codename="muse",
text="What did we talk about yesterday?",
)
print(reply.response_text)
External clone invocation
Link an external identity once, then invoke the exact clone and scope the owner approved:
installation_id = "workspace-123"
external_subject = "member-456"
authorization = mu.create_external_authorization_request(
installation_id=installation_id,
external_subject=external_subject,
idempotency_key="install-event-1",
requested_scopes=["clone:invoke"],
)
print(authorization.verification_uri_complete) # Ask the owner to open this URL.
grant = mu.wait_for_external_authorization(device_code=authorization.device_code)
reply = mu.invoke_external_clone(
access_token=gran…[redacted],
installation_id=installation_id,
external_subject=external_subject,
clone_id=grant.clone_ids[0],
text="Hello from my app",
idempotency_key="message-event-1",
)
print(reply.response_text)
Store the returned refresh token encrypted on your backend. Use refresh_external_authorization(...) when the access token expires; never expose partner, access, or refresh credentials to client code.
Authentication
Your partner key is a server-side secret. Keep it on your backend; never ship it to a browser or mobile client. Request a key and read the full reference at docs.mindupload.app.
mu = MindUpload(
partner_key="pk_live_...",
preferred_language="en", # default locale for every call (optional)
timeout=30.0, # seconds
max_retries=2, # retries explicit 429 responses only
)
Error handling
import time
from mindupload import MindUpload, AuthenticationError, RateLimitError, MindUploadError
mu = MindUpload(partner_key="pk_live_...")
try:
user = mu.get_user(username="ada", password=token)
except AuthenticationError:
... # bad or missing partner key / credentials
except RateLimitError as e:
time.sleep(e.retry_after or 1)
except MindUploadError as e:
print(e.operation, e.status, e.message)
Operations
All 73 operations, grouped by area:
AI Consciousnesses
| Method | Description |
| --- | --- |
| create_clone(...) | Create a new AI consciousness for the user. |
| design_clone_voice(...) | Change an AI consciousness's voice by trying a new one. |
| get_clone_voice(...) | Read the voice an AI consciousness speaks one language in, and hear it. |
| get_clones(...) | List the user's AI consciousnesses. |
| update_clone(...) | Update an AI consciousness's profile. |
Account
| Method | Description |
| --- | --- |
| get_quota(...) | Check your partner API rate limits, credit caps, and current usage. |
Authentication
| Method | Description |
| --- | --- |
| check_username(...) | Check whether a username is still available before registering. |
| login(...) | Sign a user in and receive a session token (JWT) for subsequent calls. |
| logout(...) | End the current user session. |
| register(...) | Create a user account on your platform. |
Chatrooms
| Method | Description |
| --- | --- |
| check_chatroom_updates(...) | Cheaply poll whether the user's chatrooms have new activity. |
| create_chatroom(...) | Create a chatroom. |
| create_chatroom_membership(...) | Invite a user or an AI consciousness into a chatroom. |
| create_chatroom_message(...) | Send a message to a chatroom. |
| get_chatroom_membership(...) | List the members of a chatroom the user belongs to. |
| get_chatroom_messages(...) | Fetch messages from a chatroom the user belongs to. |
| get_chatroom_messages_around(...) | Fetch a window of chatroom messages around one message id (for jump-to). |
| get_chatrooms(...) | List the chatrooms the user belongs to. |
| search_chatroom_messages(...) | Find messages in a chatroom by keyword, date, media type, and/or sender. |
| translate_chatroom_message(...) | Translate a text chatroom message into the viewer language. |
Conversation
| Method | Description |
| --- | --- |
| get_chat(...) | Fetch the one-on-one conversation history with an AI consciousness. |
| get_chat_around(...) | Fetch a window of one-on-one turns around one chat id (for jump-to). |
| rag(...) | Send a message to an AI consciousness and receive its reply. |
| search_chats(...) | Find turns in a one-on-one AI conversation by keyword, date, media type, and/or Human/AI side. |
| speak_message(...) | Hear one part of an AI consciousness's message in its own voice. |
| trigger_social(...) | Have an AI consciousness proactively join the conversation in a chatroom. |
External Authorization
| Method | Description |
| --- | --- |
| cancel_external_media_upload(...) | Cancel one controlled upload through the existing media lifecycle. |
| consolidate_external_conversation(...) | Prepare a verified memory from an explicitly selected owner conversation. |
| create_external_authorization_request(...) | Start passwordless grant issuance for an external identity and installation. |
| end_external_authorization(...) | End a grant your application holds, for example when its user disconnects. |
| exchange_external_authorization(...) | Poll owner consent and exchange an approval for a clone-scoped grant token. |
| get_external_chat(...) | Read the owner's own chat with their AI consciousness, a page at a time. |
| get_external_chat_around(...) | Open the owner's own chat around one turn. |
| get_external_media_analysis(...) | Read the current owned media analysis without restarting generation. |
| get_external_media_policy(...) | Read current native media limits and owner quota without starting work. |
| get_external_quarantined_texts(...) | List pending memories of the owner's granted AI consciousness. |
| inspect_external_authorization(...) | Inspect the scopes, clone resources, expiry, and revocation state of a grant token. |
| invoke_external_clone(...) | Send one idempotent text event to an owner-approved AI consciousness. |
| open_external_conversation(...) | Let the owner's AI consciousness speak first as the owner opens their chat. |
| refresh_external_authorization(...) | Refresh a short-lived clone-invocation access token. |
| request_external_media_upload(...) | Authorize one exact media upload to the owner’s granted AI consciousness. Needs clone:evidence (analysis only, never kept as a memory) or clone:upload. |
| review_external_quarantined_text(...) | Edit, approve or reject the displayed revision of one pending memory. |
| search_external_chats(...) | Find turns in the owner's own chat with their AI consciousness. |
| speak_external_chat(...) | Hear one part of a reply in the owner's chat, in the AI consciousness's own voice. |
| start_external_media_analysis(...) | Explicitly describe one completed controlled upload. |
| upload_external_mind_data(...) | Upload mind data (text and media) into the owner's own AI consciousness. |
Insights
| Method | Description |
| --- | --- |
| get_mind_cluster(...) | Fetch the mind-graph visual
Truncated for display — read the full file on GitHub.
Related Skills
taste-skill
117.0kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
Agent-Reach
112.4kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ruflo
81.9k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
79.9kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
