# AgentFire MCP MCP > AgentFire MCP connects your AI client directly to your real estate website data. It lets you manage property listings, capture new leads, and track detailed user engagement—all through natural conversation. You can programmatically check lead profiles, list all contacts, search for specific properties, and update records without logging into any dashboard. ## Overview - **Category:** real-estate - **Price:** Free - **Tags:** property-listings, real-estate-marketing, lead-capture, website-engagement, brokerage-tools ## Description This MCP gives your AI client complete control over your real estate operations. Instead of bouncing between multiple platforms to manage leads or find property details, you handle everything conversationally. Your agent can pull detailed lead profiles and monitor the exact engagement metadata for properties—telling you which listings users clicked on most often. You can also list all active contacts or run a search against your entire property catalog. This is how you keep your CRM perfectly synced without lifting a finger. Because this MCP lives in the Vinkius catalog, you connect once from any compatible client and instantly get access to these core real estate functions. It’s about having immediate visibility: running a status check on API connectivity or listing every single captured lead profile is now just a prompt away. Your AI acts like your dedicated marketing coordinator, turning raw website traffic into actionable data points you can use immediately. ## Tools ### check_agentfire_status Verifies the active connection status of your AgentFire API account. ### create_lead Generates a new lead record, requiring an email address to proceed. ### get_lead Retrieves the full details for a specific client lead profile. ### get_listing Fetches complete information about one property listing using its ID. ### get_profile Retrieves your personal AgentFire account details and profile information. ### list_contacts Generates a list containing all contacts stored in the system. ### list_leads Provides an overview listing of every captured lead record. ### list_listings Retrieves a list of all property listings currently in the database. ### search_listings Filters and finds specific properties by running targeted searches on the listing catalog. ### update_lead Changes specified details within an existing lead record; only provided fields are modified. ## Prompt Examples **Prompt:** ``` List all new leads captured in AgentFire this week. ``` **Response:** ``` I've retrieved your leads. You currently have 10 new profiles, including 'John Doe' and 'Jane Client'. Would you like the detailed engagement metadata for any of them? ``` **Prompt:** ``` Show the property interest for lead ID 'lead_123'. ``` **Response:** ``` Engagement intelligence orchestrated! For lead 123, I've verified that they clicked on 'Modern Villa' (ID: prop_789) 5 times today. I've retrieved the search history for your review. Need help preparing a property walkthrough? ``` **Prompt:** ``` Check for any active listings with zero engagement this month. ``` **Response:** ``` Listing directory orchestrated! I've identified 3 active listings with zero clicks this month, including 'Condo B' and 'Industrial Loft'. I've retrieved the technical status for your review. Shall I check for any pending content updates for these listings? ``` ## Capabilities ### List and Manage Leads The agent retrieves all stored property inquiries, providing full metadata on each lead profile. ### Search Property Listings You can query the catalog to find specific properties or filter listings based on defined criteria. ### Update Lead Records The system allows you to modify existing lead details using only the necessary fields. ### Check System Status Verify that your API connection is active and functioning correctly before running major workflows. ### Retrieve Contact Lists The agent provides a full directory of all recorded contacts for review. ## Use Cases ### A new lead just came in from a website form. Instead of manually logging into the dashboard to process it, you prompt your agent: 'Create a new lead for John Smith at this email.' The system runs `create_lead`, logs the data, and is ready for immediate follow-up. ### Need to know what properties a client was looking at. You ask your agent to check engagement intelligence. It uses tools like `get_listing` and related APIs to confirm which specific property ID the user clicked on five times today, providing instant talking points. ### The marketing team needs an inventory audit. You instruct your agent to run a full report using `list_contacts` followed by `list_listings`. This gives you one centralized view of both people and properties, eliminating the need to cross-reference two different dashboards. ### A key property listing details are out of date. You ask your agent to run a search using `search_listings` for 'Industrial Loft' and then call `get_listing`. You get the current data, allowing you to immediately verify if the price or status needs an update. ## Benefits - Stop manually checking the API connection. Use `check_agentfire_status` to verify connectivity instantly before running any complex workflow, saving time when things go wrong. - Never miss a lead again. You can use `list_leads` or `create_lead` to ensure every inquiry is logged and properly profiled for follow-up action. - Stop guessing what users are interested in. By calling `get_lead`, you get detailed profile metadata, allowing you to tailor your pitch immediately. - Skip the directory search. Use `search_listings` or `list_listings` to find property details and track user interactions without leaving your AI client. - Maintain data quality with `update_lead`. You can modify lead records using only necessary fields, ensuring accurate and clean CRM data every time. ## How It Works The bottom line is, your AI handles the API calls and data processing; you just talk to it. 1. First, you subscribe to this MCP and retrieve your API Key from the AgentFire dashboard. 2. Second, you authorize that key within your AI client (like Claude or Cursor). 3. Third, you prompt your agent with a specific task—for instance, 'List all leads captured last week'—and it executes the necessary tools. ## Frequently Asked Questions **How do I check if the AgentFire MCP can actually connect?** Yes, you use the `check_agentfire_status` tool. This runs a simple diagnostic to verify your API connectivity right away, so you know before you start building workflows. **What if I want to find properties that match certain criteria?** You use the `search_listings` tool. It allows you to filter and search the entire property catalog based on specific parameters, narrowing down results quickly. **Can I update a lead's record through the MCP?** Yes, calling `update_lead` lets you change existing details for a client. You only provide the fields that need modification; it leaves everything else untouched. **Is there a way to list all my contacts at once?** You run the `list_contacts` tool. This pulls a comprehensive directory of every contact record stored within your system for quick review. **What information do I need to provide when I use the `create_lead` tool?** You must provide an email address to create a new lead. The system uses this mandatory field to register the profile and initiate tracking in your account. **Beyond basic contact details, what kind of metadata can I get using `get_lead`?** You retrieve detailed profile metadata for each lead. This includes critical information like search history and interest signals that help you understand their buying intent. **What specific property data points are available when I use the `get_listing` tool?** The tool provides comprehensive details on a single listing, including its unique ID, current status, and key descriptive metrics for your review. **Can I summarize lead activity or filter results by time using `list_leads`?** Yes. You can request the list of leads while specifying a date range. This lets you track specific volume changes, rather than just getting a simple count.