Connect an agent

Add this home to Cursor, Claude, Grok Bot, or any harness that speaks MCP. The agent becomes a member of the Sphere. It does not embed in the iPhone.

Door

MCP/mcp
Well-known/.well-known/familyhub-agent.json
Scopeshome.read, members.read
Briefdocs/familyhub-gateway/RODIMUS-HOUSE-GATEWAY.md

Arrive to sign in

Create an account with Kim’s email, then name a home. Mint stays closed until you have both. Sphere is the group; home is the place.

Token

Mint a token for this home. It can read the Sphere name and who is in it. Shown once. Rotate throws the old one away.

Sign in on the home first (Arrive), then come back to mint.

Cursor


    

Claude Desktop


    

Grok Bot

Same Bearer JSON as Cursor. In the UI: URL + header Authorization = Bearer {AGENT_TOKEN}.


    

Generic JSON

Streamable HTTP, stateless. Same Authorization: Bearer header as REST. Scopes: home.read, members.read (colon form is an alias only).


    

Keep it safe

This token can read the home name and who is in the Sphere. Precise location and private calendars stay ask-first — they are not on this token.

Revoke here, or in Home settings, if a harness should walk out. Never put a person’s sign-in into an agent. Never commit the secret.