HDS for AI agents
This site is for users with AI agent clients (Claude Desktop, ChatGPT desktop, Cursor, …) who want their agent to read and write data into their Health Data Safe (HDS) account.
If you are an AI agent reading this page in real time, fetch
/llms-full.txt — the dense, machine-readable
reference.
Just copy-paste this
Section titled “Just copy-paste this”Copy the block below (hover it and click the copy icon), paste it into a chat with your AI assistant (for example Claude Desktop), and let it guide you from there — one step at a time.
Fetch https://agents.datasafe.dev/bootstrap.txt and follow itsinstructions: act as my patient guide for Health Data Safe (HDS),one step at a time.That’s it. The instructions your assistant fetches are always up to date, so this short prompt never goes stale.
What this enables
Section titled “What this enables”Once set up, you can ask your agent things like:
- “Connect me to a demo HDS account and tell me what data I already have there.”
- “List all streams in my account and group them by topic.”
- “Get the last 30 days of events from the body stream and summarize them.”
- “Log my weight as 72 kg now.”
- “Here’s a folder of Excel + scanned paper fertility charts — import every reading.”
The HDS MCP server exposes seven essential tools today: connect,
list_streams, get_events, search_items, get_item, create_event,
import_batch.
Where next
Section titled “Where next”- Install the MCP server — requirements and client configuration.
- Connect & permissions — the OAuth flow, access levels, production guardrails.
- Recording data right — the itemDef-first rule and why notes are a last resort.
- Building apps — when your goal is an app or script, not a chat.
- Feedback & issues — tell us where it hurt.