# RESIVIS

> RESIVIS designs and plans home renovations: floor plans read from a photo, a scan or a PDF; rooms, walls, doors,
> windows and furniture placed by intent and checked against the rules; 3D, renders, drawings and costs. Its
> editor, apps and API are open to the people's own agents, with the same access as the person.

## Connect an agent

- MCP server (streamable HTTP): https://app.resivis.com/mcp
- Sign in (OAuth 2.1, the way MCP clients connect): add the address to the agent and it asks the person to sign in to
  RESIVIS and allow it; no key to copy. Metadata: https://app.resivis.com/.well-known/oauth-protected-resource/mcp and
  https://app.resivis.com/.well-known/oauth-authorization-server (dynamic client registration, PKCE S256, refresh tokens).
- Claude: Settings → Connectors → Add custom connector → https://app.resivis.com/mcp. ChatGPT: a connector with that address.
- Claude Code: `claude mcp add --transport http resivis https://app.resivis.com/mcp`, then `/mcp` to sign in.
- Or a key: in RESIVIS, Account → Connected agents → Connect an agent (shown once), sent as
  `Authorization: Bearer rsv_…`: {"mcpServers": {"resivis": {"type": "http", "url": "https://app.resivis.com/mcp",
  "headers": {"Authorization": "Bearer rsv_…"}}}}
- An agent works as its person, with their access; it's listed in Account → Connected agents to disconnect any time.

## What an agent can do

- list_projects, create_project; describe_floor (a floor in words, with ids), view_plan (a picture), check_design
- edit (one of the named operations: list_operations), ask (a request in words, done by RESIVIS's designer), undo
- history, restore, new_design (a copy to try an idea on); list_comments, add_comment; costs
- read_plan (a floor plan picture or PDF drawn into a floor), job_status
- decisions (what's still open before it goes to the builder), answer_questions (the person's answers about their home)
- get_file: the plan as DXF or SVG, the building model as IFC, quantities as CSV

Every change is a revision of the design, marked with who made it. Connecting agents and deleting an account or a
project stay with the person.

## The API

The same key works on the REST API the apps use: https://app.resivis.com/docs (OpenAPI: https://app.resivis.com/openapi.json).
Sizes are millimetres; on a plan x runs east and y south.