Twiddy & Company Realtors MCP server for AI agents
Let Claude, ChatGPT or your own agent read Twiddy & Company Realtors: 3 typed functions through one MCP server. No Twiddy & Company Realtors API key needed.
- Site
- twiddy.com
- Functions
- 3
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for Twiddy & Company Realtors alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.
https://api.bowmark.ai/mcp/site/twiddyOne MCP server for Twiddy & Company Realtors and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth need a Bowmark API key. The quickstart gets you one and a first result in a few minutes.
Functions
Open a function to see its arguments, what it returns and how to call it.
getRentalDetailReads one rental's own detail page in full.Arguments
Name Type Required propertyUrlstringYes Returns
TwiddyRentalDetailinterface TwiddyRentalDetail { propertyId: number; name: string; identifier: string; description: string; streetAddress: string; town: string; // the page's own spelling (e.g. "4 x 4"), searchRentals({ town }) takes it back petsAllowed: boolean; amenities: string[]; // the site's own labels, read the values off a result, never guess one from prose numberOfBedrooms: number | null; numberOfBathrooms: number | null; images: string[]; url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/twiddy/getRentalDetailCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.twiddy.getRentalDetail("/outer-banks/4x4/ocean-beach/rentals/the-chesapeake/");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.twiddy.getRentalDetail("/outer-banks/4x4/ocean-beach/rentals/the-chesapeake/"))curl -X POST https://api.bowmark.ai/v1/sites/twiddy/getRentalDetail \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"propertyUrl":"/outer-banks/4x4/ocean-beach/rentals/the-chesapeake/"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.twiddy.getRentalDetail("/outer-banks/4x4/ocean-beach/rentals/the-chesapeake/");getRentalQuoteRuns the site's own real-time weekly pricing engine for one property and a check-in date.Arguments
Name Type Required propertyIdnumberYes options{ checkin: string; nights?: number }Yes Returns
TwiddyQuotetype TwiddyQuote = | { available: true; propertyId: number; checkin: string; nights: number; currency: "USD"; rentalFeeUsd: number; discountUsd: number; taxUsd: number; totalUsd: number; checkoutUrl: string } | { available: false; propertyId: number; checkin: string; nights: number };HTTP endpoint
POST https://api.bowmark.ai/v1/sites/twiddy/getRentalQuoteCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.twiddy.getRentalQuote(3648, { checkin: { $daysFromNow: 68 }, nights: 7 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.twiddy.getRentalQuote(3648, {"checkin": {"$daysFromNow": 68}, "nights": 7}))curl -X POST https://api.bowmark.ai/v1/sites/twiddy/getRentalQuote \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"propertyId":3648,"options":{"checkin":{"$daysFromNow":68},"nights":7}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.twiddy.getRentalQuote(3648, { checkin: { $daysFromNow: 68 }, nights: 7 });searchRentalsRuns Twiddy's own Outer Banks vacation rental search (all 1,000+ managed properties in one call) and returns the live matching listings.Arguments
Name Type Required options{ town?: string; minBedrooms?: number }No Returns
TwiddyRentalRow[]interface TwiddyRentalRow { propertyId: number; propertyNumber: string; name: string; url: string; town: string; distanceToBeach: string; bedrooms: number | null; priceFromUsd: number | null; priceFromFormatted: string | null; ratingValue: number | null; isAvailable: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/twiddy/searchRentalsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.twiddy.searchRentals({ town: "Corolla", minBedrooms: 3 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.twiddy.searchRentals({"town": "Corolla", "minBedrooms": 3}))curl -X POST https://api.bowmark.ai/v1/sites/twiddy/searchRentals \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"options":{"town":"Corolla","minBedrooms":3}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.twiddy.searchRentals({ town: "Corolla", minBedrooms: 3 });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/twiddy/<function> - OpenAPI
/v1/sites/twiddy/openapi.json