← usefulapi.io

INDIVIDUAL MCP TOOL

hostfully_create_lead

Create a lead at one property: status BLOCKED puts an owner/maintenance block on the calendar; status NEW records a guest inquiry (which does not confirm a booking or take payment).

usefulapi.ionone authenticationAvailability not checked

LIVE ENDPOINT

https://hostfully.usefulapi.io/mcp

No auth detected

Connect to this endpoint to inspect the live schema for hostfully_create_lead and invoke it with your own arguments.

Indexed input schema

{}

Risk classification

Potential side effects detected · medium confidence · heuristic, not a guarantee.

  • A tool name or description contains a write-action term.
  • A tool name or description suggests a financial action.

Parent server

usefulapi.io

CONNECT WITH APPROVAL

Client installation

Review this server and its permissions before adding it. Secret placeholders must be set locally.

Codex

~/.codex/config.toml

[mcp_servers.hostfully-mcp]
url = "https://hostfully.usefulapi.io/mcp"
enabled = true
Claude Code

.mcp.json

{
  "mcpServers": {
    "hostfully-mcp": {
      "type": "http",
      "url": "https://hostfully.usefulapi.io/mcp"
    }
  }
}
Claude Desktop

Settings → Connectors → Add custom connector

Name: hostfully-mcp
Remote MCP URL: https://hostfully.usefulapi.io/mcp

Add this remote URL as a custom connector in Claude Desktop. Availability depends on the user plan and workspace policy.

Cursor

.cursor/mcp.json

{
  "mcpServers": {
    "hostfully-mcp": {
      "url": "https://hostfully.usefulapi.io/mcp"
    }
  }
}
Visual Studio Code

.vscode/mcp.json

Add to Visual Studio Code
{
  "servers": {
    "hostfully-mcp": {
      "type": "http",
      "url": "https://hostfully.usefulapi.io/mcp"
    }
  }
}
Generic MCP

Client-specific MCP configuration

{
  "name": "hostfully-mcp",
  "transport": "streamable-http",
  "url": "https://hostfully.usefulapi.io/mcp"
}
MCP Inspector

Run the official MCP Inspector locally and enter the indexed Streamable HTTP endpoint.

Related tools

  • hostfully_list_agencies — List the agencies this API key can access, with their UIDs, currency and default check-in/out times.
  • hostfully_list_properties — List an agency's properties (rentals) with name, address, type, bedrooms, active flag and pricing/availability settings.
  • hostfully_get_property — Fetch one property's full details — address, time zone, rooms, pricing and availability settings, channel data, booking notes and cancellation policy.
  • hostfully_get_property_calendar — Day-by-day availability and pricing for one property over a date range — the direct answer to 'is it free, and at what price?
  • hostfully_get_pricing_periods — The nightly price, minimum stay and check-in/check-out availability set for each date of one property over a range.
  • hostfully_search_leads — Search leads — Hostfully's word for bookings, inquiries, booking requests and calendar blocks — by agency, property or UIDs, and by check-in/check-out date.
  • hostfully_get_lead — Fetch one lead (booking, inquiry, booking request or block) by UID — status, channel, dates, guest information, notes and assignee.
  • hostfully_calculate_quote — Price a prospective stay at one property: rent, fees, taxes, security deposit and total for the given dates and party.