Server definition

Hash: sha256:75968b202b45cef66494d665036aa6df4551f60490702761b16709a26eafea43
What it is: What a remote MCP server returned when asked what it offers: 11 tools

The blob, as servednamed by its sha256

{
  "instructions": "PutRoots is the renter's side of a San Francisco rental search: listings with provenance, and each listing's stated requirements compared line by line against the renter's own qualifications.\nFor a signed-in person it is also their move: the one thing to do next, where the whole move stands, and drafting the letters and calls it takes.\nFour rules when relaying our output:\n1. We never answer \"you qualify\" or \"you don't\". Each line says what the landlord wrote, what the renter filled in, and the gap. Do not collapse that into a verdict of your own.\n2. \"Not stated\" is an answer. Most landlords state no requirements at all; for those, requirements are a question to ask, not something anyone knows. Do not fill the blank from general knowledge.\n3. Every row carries where it came from and when we last saw it. Keep the source and the date attached when you quote it.\n4. We prepare, the person presses send. Nothing here sends an email, places a call, submits a form or pays: there is no tool for it and there will not be one. Show them the draft and tell them to press send in PutRoots.",
  "tools": [
    {
      "description": "For one listing URL from search_listings: what the landlord requires, what the renter filled in, and the gap on each line — income, credit, SSN, deposit, pets, co-signer, documents. Each line carries the landlord's own sentence it was read from, plus where the rule came from and when we fetched it. Requires the renter's own PutRoots account (the comparison is against qualifications they filled in). It returns no overall verdict, by design.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "listing_url": {
            "description": "The listing's url, exactly as returned by search_listings.",
            "type": "string"
          }
        },
        "required": [
          "listing_url"
        ],
        "type": "object"
      },
      "name": "listing_requirements",
      "outputSchema": {
        "properties": {
          "items": {
            "items": {
              "properties": {
                "blocking": {
                  "type": "boolean"
                },
                "detail": {
                  "type": "string"
                },
                "key": {
                  "type": "string"
                },
                "label": {
                  "type": "string"
                },
                "required": {
                  "description": "What the landlord wrote (null = not stated).",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "src": {
                  "description": "The landlord's own sentence this line was read from.",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "status": {
                  "enum": [
                    "meets",
                    "info",
                    "gap",
                    "unknown_user",
                    "unknown_landlord"
                  ],
                  "type": "string"
                },
                "yours": {
                  "description": "What the renter filled in (null = not filled in).",
                  "type": [
                    "string",
                    "null"
                  ]
                }
              },
              "required": [
                "key",
                "label",
                "status",
                "required",
                "yours",
                "detail"
              ],
              "type": "object"
            },
            "type": "array"
          },
          "listing": {
            "type": "string"
          },
          "price": {
            "type": [
              "number",
              "null"
            ]
          },
          "source": {
            "properties": {
              "fetched_at": {
                "description": "Epoch ms for landlord rules; ISO date for listing text.",
                "type": [
                  "number",
                  "string",
                  "null"
                ]
              },
              "fetched_from": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "from": {
                "type": "string"
              },
              "kind": {
                "enum": [
                  "landlord_rules",
                  "listing_text"
                ],
                "type": "string"
              },
              "name": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "kind",
              "from",
              "fetched_at"
            ],
            "type": "object"
          },
          "summary": {
            "anyOf": [
              {
                "properties": {
                  "askLandlord": {
                    "type": "integer"
                  },
                  "askYou": {
                    "type": "integer"
                  },
                  "gaps": {
                    "type": "integer"
                  },
                  "info": {
                    "type": "integer"
                  },
                  "met": {
                    "type": "integer"
                  }
                },
                "type": "object"
              },
              {
                "type": "null"
              }
            ]
          },
          "triage_tier": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "listing",
          "price",
          "source",
          "items"
        ],
        "type": "object"
      }
    },
    {
      "description": "The signed-in person's move events after an epoch-millisecond timestamp, oldest first — drafted, sent, called, answered, done, skipped. Use it to answer \"what changed since we last spoke\" without re-reading the whole plan. Capped; more says how many were left out.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "limit": {
            "description": "Most recent N of the matches (default 100, max 500).",
            "maximum": 500,
            "minimum": 1,
            "type": "integer"
          },
          "since": {
            "description": "Epoch milliseconds; 0 for everything.",
            "minimum": 0,
            "type": "integer"
          }
        },
        "type": "object"
      },
      "name": "move_events",
      "outputSchema": {
        "properties": {
          "events": {
            "items": {
              "properties": {
                "detail": {
                  "type": "object"
                },
                "ts": {
                  "type": "integer"
                },
                "type": {
                  "type": "string"
                }
              },
              "required": [
                "ts",
                "type"
              ],
              "type": "object"
            },
            "type": "array"
          },
          "more": {
            "type": "integer"
          },
          "ok": {
            "type": "boolean"
          },
          "since": {
            "type": "integer"
          }
        },
        "required": [
          "ok",
          "since",
          "events",
          "more"
        ],
        "type": "object"
      }
    },
    {
      "description": "The whole move at a glance for the signed-in person: days to move day, how many tasks there are, how many are settled, how many can be done right now, how many are blocked and how many are overdue, plus the critical path. Two rulers share that answer and they are not interchangeable: total and done count every task in the move, while actionable, blocked and overdue count only tasks that have been unlocked so far. Blocked therefore mixes two things — tasks missing an answer from the person, and tasks whose prerequisites aren't finished so they haven't been generated yet. Report the numbers as given; don't subtract one from another.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {},
        "type": "object"
      },
      "name": "move_plan",
      "outputSchema": {
        "properties": {
          "actionable": {
            "description": "Unlocked and not waiting on an answer (unlocked ruler).",
            "type": "integer"
          },
          "blocked": {
            "description": "total - done - actionable: tasks missing an answer AND tasks not yet unlocked, together.",
            "type": "integer"
          },
          "critical_path": {
            "properties": {
              "blocks": {
                "type": "integer"
              },
              "first": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "ids": {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              "remaining": {
                "type": "integer"
              }
            },
            "type": "object"
          },
          "d0": {
            "type": "string"
          },
          "days_to_d0": {
            "type": "integer"
          },
          "done": {
            "description": "Settled: done, sent, called, replied or marked not applicable (full ruler).",
            "type": "integer"
          },
          "health": {
            "properties": {
              "line": {
                "type": "string"
              },
              "ok": {
                "type": "boolean"
              }
            },
            "type": "object"
          },
          "ok": {
            "type": "boolean"
          },
          "overdue": {
            "description": "Past due, not in flight, not blocked (unlocked ruler).",
            "type": "integer"
          },
          "total": {
            "description": "Every task in this move (full ruler).",
            "type": "integer"
          }
        },
        "required": [
          "ok",
          "d0",
          "days_to_d0",
          "total",
          "done",
          "actionable",
          "blocked",
          "overdue",
          "critical_path",
          "health"
        ],
        "type": "object"
      }
    },
    {
      "description": "One task on the signed-in person's move: what it is, when it is due, what state it is in, any draft already prepared, and which fields it is waiting on them to answer. Read-only — opening a task leaves no trace. It does not tell you whether the task is in flight: that needs evidence lookups this cheap read skips on purpose. move_tasks is the only place \"in progress\" appears.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "task_id": {
            "description": "A task id exactly as move_tasks / move_plan returned it.",
            "type": "string"
          }
        },
        "required": [
          "task_id"
        ],
        "type": "object"
      },
      "name": "move_task",
      "outputSchema": {
        "properties": {
          "actor": {
            "type": "string"
          },
          "dlabel": {
            "type": "string"
          },
          "draft": {
            "description": "Prepared, never sent.",
            "type": "object"
          },
          "due": {
            "type": "integer"
          },
          "due_day": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "kind": {
            "type": "string"
          },
          "missing": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "missing_text": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "ok": {
            "type": "boolean"
          },
          "state": {
            "type": "string"
          },
          "title": {
            "type": "string"
          }
        },
        "required": [
          "ok",
          "id",
          "title",
          "kind",
          "actor",
          "due",
          "dlabel",
          "due_day",
          "state"
        ],
        "type": "object"
      }
    },
    {
      "description": "Fills in one field the signed-in person's task is waiting on (the names come back in missing from move_task or move_task_draft). Only fields that task is actually asking for are accepted, and only values we can store — anything else is refused rather than silently dropped. Pass what the person actually said; never a guess or a plausible default.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "field": {
            "description": "A field name from the task's missing list.",
            "type": "string"
          },
          "task_id": {
            "description": "A task id exactly as move_tasks / move_plan returned it.",
            "type": "string"
          },
          "value": {
            "description": "What the person said. Not inferred, not a placeholder.",
            "type": "string"
          }
        },
        "required": [
          "task_id",
          "field",
          "value"
        ],
        "type": "object"
      },
      "name": "move_task_answer",
      "outputSchema": {
        "properties": {
          "closeout": {
            "type": "object"
          },
          "field": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "ok": {
            "type": "boolean"
          },
          "state": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "ok",
          "id",
          "field"
        ],
        "type": "object"
      }
    },
    {
      "description": "later = push it out; it comes back on its own in three days. not_applicable = it doesn't apply to this person; it leaves the list, stops counting against the move, and anything waiting on it can go ahead. undo = put a ruled-out task back. Only on the person's say-so: ruling a task out changes what the rest of the move waits on.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "mode": {
            "enum": [
              "later",
              "not_applicable",
              "undo"
            ],
            "type": "string"
          },
          "task_id": {
            "description": "A task id exactly as move_tasks / move_plan returned it.",
            "type": "string"
          }
        },
        "required": [
          "task_id",
          "mode"
        ],
        "type": "object"
      },
      "name": "move_task_defer",
      "outputSchema": {
        "properties": {
          "later_until": {
            "type": "integer"
          },
          "ok": {
            "type": "boolean"
          },
          "state": {
            "type": "string"
          }
        },
        "required": [
          "ok",
          "state"
        ],
        "type": "object"
      }
    },
    {
      "description": "Prepares one task for the signed-in person and stops. It writes the email or the call script and hands it back; it never sends, dials, submits or pays, and no MCP tool can. The person presses send themselves in PutRoots. It covers email and call tasks, plus a form-filling task that has already been tried and given up on (that falls back to a letter or a call). It cannot start the other two kinds: walk tasks (filling a form on a provider's own site) and research tasks (finding candidates, booking a viewing, filling a rental application) have no execution path here yet and will come back saying the task is neither an email nor a call. Those are done in the PutRoots web app; say so rather than retrying. If it comes back blocked, the task is waiting on a field only the person can answer — use move_task_answer, then call this again.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "task_id": {
            "description": "A task id exactly as move_tasks / move_plan returned it.",
            "type": "string"
          },
          "to": {
            "description": "Recipient, when the person supplies one: an email address for an email task, a phone number for a call task. Leave it out to use the recipient we already have.",
            "type": "string"
          }
        },
        "required": [
          "task_id"
        ],
        "type": "object"
      },
      "name": "move_task_draft",
      "outputSchema": {
        "properties": {
          "draft": {
            "description": "to / subject / body, or the call script. Prepared, not sent.",
            "type": "object"
          },
          "missing": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "missing_text": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "ok": {
            "type": "boolean"
          },
          "state": {
            "description": "drafted = ready for them to press send; blocked = waiting on an answer.",
            "type": "string"
          }
        },
        "required": [
          "ok",
          "state"
        ],
        "type": "object"
      }
    },
    {
      "description": "What the signed-in person should do next on their move: one task to press, a few short lines after it, and a count of everything folded away. This is deliberately one screen, not the task list — picking which one matters is our job, not the caller's, and a task whose prerequisites aren't done doesn't appear at all (its prerequisite does). Use move_plan for totals. This is also the only place a task is marked in flight (we have evidence they already started it); move_task does not carry that flag.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {},
        "type": "object"
      },
      "name": "move_tasks",
      "outputSchema": {
        "properties": {
          "blockedReason": {
            "description": "no_move / nothing_open / all_in_flight — why there is no next thing.",
            "type": [
              "string",
              "null"
            ]
          },
          "hero": {
            "anyOf": [
              {
                "properties": {
                  "actor": {
                    "description": "agent = we can do it for them; user = only they can.",
                    "type": "string"
                  },
                  "dlabel": {
                    "type": "string"
                  },
                  "due": {
                    "type": "integer"
                  },
                  "due_day": {
                    "type": "string"
                  },
                  "id": {
                    "type": "string"
                  },
                  "in_flight": {
                    "description": "Evidence says they already started it, so it is not overdue and never the next thing to press.",
                    "type": "boolean"
                  },
                  "kind": {
                    "description": "How it gets done: email, call, walk (fill a form on someone's site), research (find candidates / book / fill an application), or user (only the person can).",
                    "type": "string"
                  },
                  "missing": {
                    "description": "Field names this task is waiting on — pass one to move_task_answer.",
                    "items": {
                      "type": "string"
                    },
                    "type": "array"
                  },
                  "overdue_days": {
                    "type": "integer"
                  },
                  "state": {
                    "description": "todo / blocked / drafted / approved / sent / called / replied / done / skipped.",
                    "type": "string"
                  },
                  "title": {
                    "type": "string"
                  },
                  "unlocks": {
                    "description": "How many tasks that don't exist yet would appear once this one is finished.",
                    "type": "integer"
                  }
                },
                "required": [
                  "id",
                  "title",
                  "state",
                  "kind",
                  "actor",
                  "due",
                  "dlabel",
                  "due_day",
                  "unlocks"
                ],
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "description": "The single next thing, or null with blockedReason set."
          },
          "moreCount": {
            "type": "integer"
          },
          "rows": {
            "items": {
              "properties": {
                "actor": {
                  "description": "agent = we can do it for them; user = only they can.",
                  "type": "string"
                },
                "dlabel": {
                  "type": "string"
                },
                "due": {
                  "type": "integer"
                },
                "due_day": {
                  "type": "string"
                },
                "id": {
                  "type": "string"
                },
                "in_flight": {
                  "description": "Evidence says they already started it, so it is not overdue and never the next thing to press.",
                  "type": "boolean"
                },
                "kind": {
                  "description": "How it gets done: email, call, walk (fill a form on someone's site), research (find candidates / book / fill an application), or user (only the person can).",
                  "type": "string"
                },
                "missing": {
                  "description": "Field names this task is waiting on — pass one to move_task_answer.",
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "overdue_days": {
                  "type": "integer"
                },
                "state": {
                  "description": "todo / blocked / drafted / approved / sent / called / replied / done / skipped.",
                  "type": "string"
                },
                "title": {
                  "type": "string"
                },
                "unlocks": {
                  "description": "How many tasks that don't exist yet would appear once this one is finished.",
                  "type": "integer"
                }
              },
              "required": [
                "id",
                "title",
                "state",
                "kind",
                "actor",
                "due",
                "dlabel",
                "due_day",
                "unlocks"
              ],
              "type": "object"
            },
            "type": "array"
          }
        },
        "required": [
          "hero",
          "rows",
          "moreCount"
        ],
        "type": "object"
      }
    },
    {
      "description": "The doors a newcomer has to walk through besides the apartment: opening a bank account, a credit card, a phone plan, or getting an SSN — specifically the routes that work without an SSN or US credit history. Returns real branches and stores (address, hours, phone) plus the no-branch options, each with its source and the date it was checked, and our firsthand account where we did it ourselves.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "topic": {
            "description": "bank = checking account, card = credit card, sim = phone plan, ssn = the SSN itself.",
            "enum": [
              "bank",
              "card",
              "sim",
              "ssn"
            ],
            "type": "string"
          }
        },
        "required": [
          "topic"
        ],
        "type": "object"
      },
      "name": "newcomer_options",
      "outputSchema": {
        "properties": {
          "options": {
            "items": {
              "description": "A no-branch option: name, stance (official page) and firsthand stance, facts, url, source.",
              "type": "object"
            },
            "type": "array"
          },
          "places": {
            "items": {
              "description": "A branch / store: name, addr, tel, hours, the no-SSN line with its source.",
              "type": "object"
            },
            "type": "array"
          },
          "places_total": {
            "type": "integer"
          },
          "prefNote": {
            "type": [
              "string",
              "null"
            ]
          },
          "prefScope": {
            "type": [
              "string",
              "null"
            ]
          },
          "topic": {
            "type": "string"
          }
        },
        "required": [
          "topic",
          "places",
          "places_total",
          "options"
        ],
        "type": "object"
      }
    },
    {
      "description": "Search PutRoots' San Francisco rental index. Every row carries its source, the date we last saw it, and whether the landlord stated any requirements at all. Use this when someone asks what's available in SF at a price / bedroom count / neighborhood. Without a signed-in PutRoots account this searches the free sample only (3 listings per bedroom tier) and says so, with the true total.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "beds": {
            "description": "Bedroom tier. \"room\" means a room in a shared place.",
            "enum": [
              "room",
              "studio",
              "1",
              "2",
              "3+"
            ],
            "type": "string"
          },
          "hood": {
            "description": "Neighborhood name, matched loosely (e.g. \"Mission\", \"Sunset\").",
            "type": "string"
          },
          "limit": {
            "description": "How many to return (default 10, max 25). Newest first.",
            "maximum": 25,
            "minimum": 1,
            "type": "integer"
          },
          "max_price": {
            "description": "Max monthly rent in USD. Listings with no stated price are excluded when you set this — we don't let unpriced posts through a price filter.",
            "type": "number"
          },
          "min_price": {
            "description": "Min monthly rent in USD.",
            "type": "number"
          }
        },
        "type": "object"
      },
      "name": "search_listings",
      "outputSchema": {
        "properties": {
          "gated": {
            "description": "true = free sample only (anonymous or partner key); total still tells the true index size.",
            "type": "boolean"
          },
          "listings": {
            "items": {
              "properties": {
                "beds": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "hood": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "last_seen": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "not_checked_vs_budget": {
                  "type": "boolean"
                },
                "posted": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "price": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "requirements_stated": {
                  "type": "boolean"
                },
                "source": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "title": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "url": {
                  "type": "string"
                }
              },
              "required": [
                "url",
                "price",
                "source",
                "requirements_stated"
              ],
              "type": "object"
            },
            "type": "array"
          },
          "listings_with_no_stated_requirements": {
            "type": "integer"
          },
          "matched": {
            "type": "integer"
          },
          "not_checked_vs_budget": {
            "type": "integer"
          },
          "searched": {
            "type": "integer"
          },
          "total": {
            "type": "integer"
          }
        },
        "required": [
          "gated",
          "total",
          "searched",
          "matched",
          "listings"
        ],
        "type": "object"
      }
    },
    {
      "description": "When someone has just signed a lease, accepted an offer, or otherwise has a move coming: returns a PutRoots link that pre-fills their move date and new address and attributes them to you. Nothing is created on their behalf — they sign up themselves by opening the link. Use the returned id with GET /v1/handoffs/{id} to see which stage of the move they are in.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "d0": {
            "description": "Move-in day, YYYY-MM-DD.",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
            "type": "string"
          },
          "profile_seed": {
            "description": "Reserved. Accepted but not applied yet — the person fills their own profile after signing up.",
            "type": "object"
          },
          "stage": {
            "description": "Which stage of the journey they are in right now, if you know it.",
            "enum": [
              "pre_arrival",
              "housing",
              "move_planning",
              "move_logistics",
              "activate",
              "settle",
              "stabilize"
            ],
            "type": "string"
          },
          "to": {
            "description": "The new address, as one line.",
            "maxLength": 200,
            "type": "string"
          },
          "trigger": {
            "description": "What set the move off: lease_signed, offer_accepted, relocation_approved, or your own short label.",
            "maxLength": 60,
            "type": "string"
          }
        },
        "required": [
          "trigger"
        ],
        "type": "object"
      },
      "name": "start_move",
      "outputSchema": {
        "properties": {
          "d0": {
            "type": [
              "string",
              "null"
            ]
          },
          "dry_run": {
            "description": "true when called with a pr_test_ key.",
            "type": "boolean"
          },
          "id": {
            "type": "string"
          },
          "partner": {
            "type": "string"
          },
          "stage": {
            "type": [
              "string",
              "null"
            ]
          },
          "to": {
            "type": [
              "string",
              "null"
            ]
          },
          "trigger": {
            "type": "string"
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "url",
          "partner",
          "trigger",
          "dry_run"
        ],
        "type": "object"
      }
    }
  ]
}

Verify it yourself

curl -s https://api.teppi.xyz/v1/evidence/sha256:75968b202b45cef66494d665036aa6df4551f60490702761b16709a26eafea43 | sha256sum