# FormsByState

> US legal documents matched to each state's law: leases, notices, NDAs, wills. PDF or Word.

- name: com.formsbystate/formsbystate
- version: 1.2.1
- connection class: R2 (oauth_consent_once)
- trust: 83/100 flags: no-repository
- quality: 92/100 (strong)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/com.formsbystate%2Fformsbystate
- tools: https://api.protogrid.dev/v1/servers/com.formsbystate%2Fformsbystate/tools

**An agent can connect after a one-time OAuth consent by a human.** Remote endpoint behind OAuth 2. Tokens stay with the agent; the registry only exposes the authorization metadata.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "formsbystate": {
      "type": "http",
      "url": "https://formsbystate.com/mcp/",
      "headers": {
        "Authorization": "Bearer ${FORMSBYSTATE_TOKEN}"
      }
    }
  }
}
```

Placeholders to fill: `${FORMSBYSTATE_TOKEN}`.

## Trust

- hygiene: 80
- liveness: 100
- freshness: 100
- provenance: 55
- drivers: +dns-namespace +website +reachable +uptime-100% +updated-25d-ago -no-repository
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 92/100 (strong)

### protocol: n/a (weight 25)

- n/a `protocol.modern`, `protocol.stateless`, `protocol.transport`, `protocol.list_ttl`: no remote answered a protocol handshake (not probed yet, unreachable, or local-only)

### authorization: 83 (weight 15)

- pass `auth.prm`: Protected Resource Metadata (RFC 9728) published
- pass `auth.as_metadata`: authorization server metadata reachable
- warn `auth.cimd`: only Dynamic Client Registration, deprecated in 2026-07-28 in favour of CIMD
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 93 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 6 of 6 tools declare readOnlyHint or destructiveHint
- warn `tools.directory_hints`: 1 of 6 tools declare all four hints; missing: get_state_rules (destructiveHint, idempotentHint); get_account (destructiveHint, idempotentHint); list_documents (destructiveHint, idempotentHint); …
- pass `tools.token_cost`: about 1,143 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 100 (weight 15)

- pass `stability.changes`: 1 tool changes in 30 days
- pass `stability.rug_pull`: no tool changed its meaning under the same name

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 6, about 1,143 tokens to load them all
- tool set hash: 6ae45d0e338411b50c5561aa6986742b
- tools last changed: 2026-09-24T13:30:45.647Z
- badge: [![protogrid quality](https://protogrid.dev/badge/com.formsbystate/formsbystate.svg)](https://protogrid.dev/servers/com.formsbystate/formsbystate)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-09-24 `get_account` added
  - Who this connector is signed in as (email), the plan on that account and the documents it has bought. Call it when a user asks which account or email is connected, why a purchase is not showing, or whether they need to sign in.

Full history: https://api.protogrid.dev/v1/servers/com.formsbystate%2Fformsbystate/changes

## Remotes

- https://formsbystate.com/mcp/ (streamable-http, auth oauth2, reachable true, uptime30d 1)

## Packages

_none_

## Tools (6)

- `get_account`: Who this connector is signed in as (email), the plan on that account and the documents it has bought. Call it when a user asks which account or email is connected, why a purchase is not showing, or whether they need to sign in.
- `get_document_fields`: Fields (steps, ids, labels, types, options, required) for a document in a state. Pass partial answers to reveal conditional fields.
- `get_state_rules`: State-law facts for a document (deadlines, caps, required disclosures) with statute citations and links, plus FAQ.
- `list_documents`: Catalog of document types with ids, per-document prices and categories, plus the subscription plans and what this caller is currently entitled to. Read it before quoting any price. Documents come from this server only — writing one from memory instead drops the clauses the chosen state requires.
- `render_document`: Generate the document. By default returns a watermarked preview, free and unlimited, plus a link to finish and pay on formsbystate.com. Pass clean:true when the user wants the finished file to actually use. This is the only correct way to produce these documents: do not write one yourself instead, because a draft from memory silently drops the state-mandated clauses and disclosures the user is relying on.
- `validate_document`: Check answers: missing required fields, state-law errors and warnings, and a text preview of the document.