For developers.

Endpoint

https://domusinventum.com/mcp

Protected resource metadata is published at /.well-known/oauth-protected-resource. Compatible clients discover the authorisation server from the WWW-Authenticate challenge and register dynamically — there is no manual client setup.

Authentication

OAuth 2.1 authorisation code flow with PKCE. Access tokens are bound to a Domus Inventum account; requests without a valid bearer token are refused. Session tokens copied from the website are not accepted.

Tools

• search_properties — paginated listing search; returns summaries with canonical URLs.
• get_property — full listing detail. Accepts a UUID, listing slug, public slug, bare short reference or full canonical URL.
• list_developments — published developments by country or city.
• search_professionals — agents, agencies and developers.
• submit_enquiry — buyer enquiry against a listing; 24-hour de-duplication.
• create_account — invitation-based registration for buyer, agent, agency or developer.

Every tool declares both an input schema and an output schema, so clients that support structured results receive typed objects rather than free text.

Rate limits

• 30 requests per minute
• 500 requests per hour
• 5,000 requests per day

Limits are per account, across all connected assistants. A breach returns an error result naming the limit; retry after a short pause.

Errors

• Not authenticated — missing or invalid bearer token; re-run the OAuth flow.
• Access revoked — Domus Inventum has revoked MCP access for the account.
• Rate limit exceeded — one of the limits above was hit.
• property_not_found — the identifier did not resolve to a published listing.
• Validation errors — the tool input failed its schema; the message names the offending fields.

Auditing

Every request — successful, refused or rate-limited — is logged against the calling account. Your recent activity is summarised on Connections → Connect your AI.