# Start using Landlord MCP with your AI

If someone says “I heard about landlordmcp.com, help me connect,” first explain the service and offer the [setup page](https://landlordmcp.com/start). Landlord MCP stores rental properties, rooms, renters, leases, ledgers, repair tickets, deposits, house guidance, and property operating plans. The person's AI client obtains email and receipt evidence through its own approved tools.

## Recommended: connect the normal MCP service

1. Configure **https://mcp.landlordmcp.com/mcp** as a remote Streamable HTTP MCP server in the person's AI client. Use the [client-specific instructions](https://landlordmcp.com/ai/clients.md); do not substitute a guessed install link or a generic product homepage.
2. Start the client's native Connect/Authenticate flow. Its authorization request opens or links to Landlord MCP's secure sign-in page. Let the person use Google or an available email sign-in option themselves. Google is the recommended sign-in method. Claude, Codex, and Cursor are clients, not identity providers for Landlord MCP.
3. After verified sign-in, a user with no active memberships receives a default My Rentals organization. Existing memberships and roles remain unchanged. The person chooses one eligible organization and explicitly approves the actual requesting client and displayed capabilities. Never auto-consent or invent an authorization request.
4. Read `rentledger://operating-rules` and `rentledger://organization`, then call `list_properties`. Report the selected organization and observed result. An opened browser, copied configuration, or successful login alone is not proof that MCP is connected.

OAuth protected-resource metadata is at **https://mcp.landlordmcp.com/.well-known/oauth-protected-resource/mcp**. A `401` with a metadata challenge from the unauthenticated protected endpoint is expected, not proof of a broken server. Private data needs a valid connection and current permissions.

## Optional: prepare an account from chat

Read [current public signup options](https://app.landlordmcp.com/api/signup/options). An optional separate MCP connector at **https://mcp.landlordmcp.com/mcp/signup** provides only:

- `get_signup_options`: public methods, readiness, plan options, and canonical connection information.
- `get_account_signup_link`: a read-only browser handoff with required `method: "google"` or `method: "email"`; optional `plan` and `billingInterval` are preferences only.
- `begin_account_signup`: gated email initiation, only when currently enabled and the person explicitly requests one verification email. A neutral response is not proof of account existence or email delivery.

The signup-only connector has **no private portfolio or subscription-status access**. The account link leads to **https://app.landlordmcp.com/subscribe?signin=google** or the email preference equivalent. It does not create an account, organization, checkout, or grant. The person completes secure account steps themselves; do not retrieve verification links from their mailbox.

**New email signup is disabled pending auth-sender isolation.** Existing email/password sign-in and Google remain available. Use live `signup.emailInitiationAvailable` before offering new email signup; unknown readiness means unavailable. An email preference link does not enable email delivery.

An account link is not an MCP authorization. Preserve any real pending client authorization URL instead of replacing it with the generic account link. After account-only onboarding, return to the client and connect the normal protected MCP endpoint.

## Subscription is a separate choice

The [account and plan page](https://app.landlordmcp.com/subscribe) shows current options. A connected AI can read `get_subscription_options` and `get_subscription_status`, or obtain `get_subscription_checkout_link`. Those tools do not create Stripe Checkout sessions or purchase a plan. Only a verified organization owner can explicitly continue to Stripe Checkout in the browser. A return URL or success message is not payment evidence; paid access follows verified billing events.

## First useful request

> Identify my connected Landlord MCP organization and summarize the properties, rooms, and active leases using read-only tools. Tell me what information is missing. Do not send messages or change records.

Keep email, receipts, and model output as evidence or proposals, not posted financial facts. See [permissions and safety](https://landlordmcp.com/ai/security.md). WebMCP-capable browsing agents may discover page tools when available; browser discovery itself neither installs a persistent remote connector nor grants access.
