Connect AI

Use Acquisition Atlas directly from your AI assistant. Acquisition Atlas provides a live feed of county filings — tax liens, municipal liens, and other public records — matched to properties with extracted ownership details, property valuations, lien amounts, filing dates, and contact data.

The Acquisition Atlas MCP server gives AI tools like Claude Desktop, Cursor, and Claude Code full access to the platform — search filings, manage saved lists and deal alerts, favorite and archive properties, manage your buyer pipeline, run a full deal pipeline, schedule and track calendar follow-ups, manage agent buyer profiles, upload documents and images, import buyers from CSV, collaborate with teams, share links, check notifications, search business entities, and read the full API documentation — all through natural language.

Quick Start

Getting connected takes under 2 minutes.

Install the MCP server:

npx @acqatlas-tools/mcp-server

That's the core command. Your AI client runs this automatically — you just need to add a config file with your API key, and the client handles the rest. The server automatically authenticates you and enables all tools for your account.

Prerequisites:

1. An Acquisition Atlas API key — Get one here
2. Node.js 18 or later — Download

Pick your AI client below for a step-by-step setup guide:

Client	Guide
Claude Desktop	Setup guide →
Cursor	Setup guide →
Claude Code	Setup guide →
OpenClaw	Setup guide →

Each guide includes the config snippet, file location, and verification steps. Setup takes under 2 minutes.

What You Can Do

Ask your AI assistant things like:

Search filings:

• "Find all tax lien filings in Miami-Dade county over $10,000"
• "Show me statistics for Franklin County"
• "Search for filings related to Smith Family Trust"
• "Get full property details and comps for filing #12345"

Manage saved lists & deal alerts:

• "Create a new lead list called 'High Equity Targets'"
• "Add this property to my active lead list"
• "Set up a deal alert for Franklin County tax liens over $5,000"
• "Show me all my deal alerts and their notification settings"
• "Duplicate my 'Q1 Prospects' list"

Track properties:

• "Favorite this property"
• "Archive all the liens I've already reviewed"
• "Mark this property as having an active deal"
• "Which of my lists contain this property?"

Manage your buyers:

• "Add John Smith as a fix-and-flip buyer with email john@example.com"
• "Show me all my active buyers in Franklin County"
• "Tag buyer John Smith as 'Cash Buyer' and 'Fix and Flip'"
• "Which of my buyers match this tax lien property?"
• "Export all my buyer contacts as JSON"
• "Import buyers from this CSV file"
• "Upload a proof of funds document for this buyer"

Manage deals:

• "Create a deal for 123 Main St with an ARV of $150,000"
• "Move this deal to the 'Under Contract' stage"
• "What are my active deal stats?"
• "Which buyers match this deal?"
• "Upload the purchase agreement for this deal"
• "Convert this tax lien filing into a deal"

Calendar & follow-ups:

• "Show me all follow-ups scheduled this week"
• "Schedule a follow-up call with this buyer for tomorrow"
• "Mark this follow-up as completed"
• "Reschedule my deal follow-up to next Friday"

Collaborate with teams:

• "Create a team called 'Midwest Acquisitions'"
• "Share my Q1 Prospects list with the team"
• "Generate a share link for this property"

Stay informed:

• "How many unread notifications do I have?"
• "Mark all notifications as read"
• "Show me my investment profile"

Search business entities:

• "Search for 'Smith Family Trust LLC'"
• "Show my entity search history"
• "Save this entity search for later"

The AI selects the right tool, calls the API with your key, and returns structured results.

What is MCP?

Model Context Protocol (MCP) is an open standard that lets AI assistants connect to external data sources and tools. Instead of manually calling APIs and pasting results, your AI can call the Acquisition Atlas API directly and reason about the data.

MCP servers communicate over stdio — the AI client launches the server as a local process, sends JSON-RPC requests over stdin, and reads responses from stdout. Your API key stays local and is never sent to the AI provider.

How it works

1. You add the config snippet to your AI client with your API key
2. The client runs npx @acqatlas-tools/mcp-server — this downloads and starts the server
3. The server calls GET /v1/me to verify your identity from the API key
4. If authenticated, 94 tools and 23 resources are registered across 16 feature areas
5. When you ask a question, the AI calls the appropriate tool
6. Filing tools make HTTP requests to api.acqatlas.com; all other tools connect directly to the database
7. Results come back as structured JSON that the AI can analyze

If the API key can't be verified (invalid key or network issue), only the 11 public tools are registered (8 filing + 3 enriched lien). The remaining 83 authenticated tools require verified user identity.

Available Tools

The MCP server provides up to 94 tools depending on your account status.

Filing Tools (8)

Always available. These query the public Acquisition Atlas filing data API:

Tool	Description
list_filings	List filings with filters (county, amount, date, property type, geo bounds)
get_filing	Get full details of a single filing by ID
search_filings	Full-text search across owner names, addresses, case numbers
get_stats	Aggregate statistics for the entire database
get_county_stats	Per-county statistics, optionally filtered by state
list_counties	All counties with available filing data
get_date_ranges	Available date ranges for a specific county
get_months	Available months (YYYY-MM) for a specific county

Enriched Lien Details (3)

Always available. Direct database access for full property data:

Tool	Description
get_lien_details	Full property details with all ATTOM enrichment data (beds, baths, sqft, value, equity)
get_related_liens	Find comparable/related properties by county, type, and amount
get_property_comps	Sales comparables with aggregate stats (avg, median, min, max prices)

Buyer CRM Tools (17)

Full CRUD for your buyer pipeline, plus documents, images, and CSV import:

Tool	Description
list_buyers	Search, filter, and paginate your buyer contacts
get_buyer	Get full details of a buyer including tags
create_buyer	Add a new buyer contact with emails, phones, and details
update_buyer	Update any buyer fields (partial updates supported)
delete_buyer	Remove a buyer and all related data
get_buyer_stats	Dashboard stats — total, active, new this month, follow-ups due
manage_buyer_tags	List, create, update, delete, assign, or remove tags
manage_buyer_notes	List, create, update, or delete notes on a buyer
log_buyer_activity	Log calls, emails, meetings, or list recent activity
manage_buy_boxes	Create, update, list, or delete a buyer's buy box criteria
match_buyers_to_property	Score all buyers against a specific filing/property (0–100)
manage_buyer_saved_filters	Save, list, or delete search filter presets
export_buyers	Export all buyer contacts as structured JSON with optional buy boxes
manage_buyer_follow_ups	List pending, complete, update (reschedule), or delete follow-ups
manage_buyer_documents	Upload documents (PDF, Office, CSV), list, and delete — presigned S3 URLs
manage_buyer_images	Upload or set buyer profile images (S3 or external URLs)
import_buyers	Import buyers from CSV data (up to 5,000 rows) with field mapping and dedup

Saved Lists (12)

Create, manage, and organize property lead lists:

Tool	Description
list_saved_lists	List your saved lists with optional type filter and pagination
get_saved_list	Get a list by ID with lead count
get_saved_list_leads	Get properties in a list with pagination
create_saved_list	Create a static, dynamic, snapshot, or lead list
update_saved_list	Update name, description, filters, notification settings
delete_saved_list	Soft-delete a list (recoverable)
duplicate_saved_list	Copy a list including all its leads
add_lead_to_list	Add a property to a list
remove_lead_from_list	Remove a property from a list
get_lead_lists_for_lien	Which of your lists contain a specific property?
set_active_lead_list	Set your default lead list
get_active_lead_list	Get your current active lead list

Deal Alerts (4)

Manage notifications for new property matches:

Tool	Description
get_alerts	Get all your active deal alerts with filter criteria
get_deal_alerts_status	Check if you have alerts configured and summary stats
save_deal_alerts	Create or update a deal alert with filter criteria and frequency
update_alert	Toggle notifications, change frequency or channels

Lien Preferences (5)

Favorite, archive, and track deal status on properties:

Tool	Description
toggle_lien_favorite	Toggle favorite status on a property
toggle_lien_archived	Toggle archived status on a property
mark_lien_has_deal	Mark a property as having an active deal
unmark_lien_has_deal	Remove the deal flag from a property
get_lien_preferences	Get your preferences for one or more properties (batch)

Teams (6)

Collaborate with team members:

Tool	Description
list_teams	List all teams you belong to
get_team	Get team details with member list
create_team	Create a new team (you become owner)
get_team_shared_lists	Get lists shared with a team
share_list_with_team	Share one of your lists with a team
unshare_list_from_team	Remove a shared list from a team

Sharing (3)

Generate shareable links for properties and lists:

Tool	Description
create_lien_share_link	Generate a shareable link for a property
get_my_shared_links	List your shared links with view counts
generate_list_share_link	Generate a shareable link for a saved list

Notifications (4)

Check and manage your notifications:

Tool	Description
get_notifications	Get your notifications with optional unread filter
get_unread_notification_count	Get count of unread notifications
mark_notification_read	Mark a single notification as read
mark_all_notifications_read	Mark all notifications as read

Entity Search (6)

Search and manage business entity lookups:

Tool	Description
search_entity_by_name	Search for a business entity by name (uses cached results)
get_entity_search_status	Check the status of an entity search
get_entity_search_history	Your past entity searches
get_business_lists	Your saved entity search collections
create_business_list	Save an entity search for future reference
add_search_to_list	Link an entity search to a saved list

Deal Pipeline (17)

Full deal management from lead to close:

Tool	Description
list_deals	Search, filter, and paginate deals by status, stage, priority
get_deal	Full deal details with stage, financials, seller info
create_deal	Create a new deal with property details and financials
update_deal	Update deal fields (partial updates)
delete_deal	Remove a deal and all related data
get_deal_stats	Dashboard stats — active, pipeline value, won/lost
move_deal_to_stage	Move a deal to a different pipeline stage
convert_lien_to_deal	Convert a filing/lien into a deal
manage_deal_pipeline_stages	Create, update, reorder, or delete pipeline stages
manage_deal_tags	List, create, assign, remove, or delete deal tags
manage_deal_notes	List, create, update, or delete notes on a deal
log_deal_activity	Log activity (calls, emails, site visits) on a deal
manage_deal_follow_ups	List pending, complete, update, or delete deal follow-ups
match_buyers_to_deal	Score buyers against a deal's criteria (0–100)
get_deal_buyer_matches	Get/update buyer match results for a deal
manage_deal_documents	Upload deal documents (contracts, title reports, etc.) — presigned S3 URLs
manage_deal_images	Upload or set deal property images

Calendar (5)

Unified follow-up calendar across buyers and deals:

Tool	Description
get_calendar_events	Get all follow-ups in a date range (buyers + deals combined)
create_follow_up	Schedule a follow-up for a buyer or deal
complete_follow_up	Mark a follow-up as completed
update_follow_up	Reschedule or edit a follow-up
delete_follow_up	Remove a follow-up

Agents (2)

Manage agent/broker contacts and their buyer profiles:

Tool	Description
list_agents	List agent/broker contacts with their buyer profiles
manage_agent_buyer_profiles	Add, update, or remove buyer profiles on an agent

Profile (2)

View your account and investment profile:

Tool	Description
get_my_profile	Get your user profile (name, email, company, social links)
get_acquisition_profile	Get your AI-learned investment preferences and behavioral summary

Available Documentation Resources

The server also exposes the full API documentation as MCP resources. Your AI can read these to answer questions about the API without making network requests:

Resource	Content
acqatlas://docs/intro	API introduction and overview
acqatlas://docs/quickstart	Getting started guide
acqatlas://docs/authentication	API key authentication
acqatlas://docs/endpoints/list-filings	List Filings endpoint reference
acqatlas://docs/endpoints/get-filing	Get Filing endpoint reference
acqatlas://docs/endpoints/search-filings	Search Filings endpoint reference
acqatlas://docs/endpoints/stats	Statistics endpoint reference
acqatlas://docs/endpoints/county-stats	County Statistics endpoint reference
acqatlas://docs/endpoints/counties	List Counties endpoint reference
acqatlas://docs/endpoints/date-ranges	Date Ranges endpoint reference
acqatlas://docs/endpoints/months	Available Months endpoint reference
acqatlas://docs/response-format	API response format guide
acqatlas://docs/field-reference	Complete field reference
acqatlas://docs/rate-limits	Rate limits by tier
acqatlas://docs/tier-comparison	Tier feature comparison
acqatlas://docs/pricing	Pricing overview
acqatlas://docs/changelog	API changelog
acqatlas://docs/connect-ai	This page

Troubleshooting

"ACQATLAS_API_KEY environment variable is required"

Make sure you've added your API key to the env block in your MCP config. The key should start with ak_live_.

"Authentication failed"

Your API key may be invalid or expired. Generate a new one at app.acqatlas.com/settings/api.

"Authenticated tools disabled"

The server couldn't verify your identity on startup. This usually means:

• Your API key is invalid — check that it starts with ak_live_ and was copied correctly
• Network is unavailable — the server needs internet to call GET /v1/me on startup
• The 11 public tools still work (filing data + enriched lien details); the 83 authenticated tools (buyer CRM, deals, calendar, lists, alerts, teams, etc.) are disabled

Restart the MCP server after fixing the issue to re-attempt authentication.

"Rate limit exceeded"

You've hit your tier's rate limit. Wait a moment and try again, or upgrade your plan for higher limits. See Rate Limits for details.

Server doesn't start

• Ensure Node.js 18+ is installed: node --version
• Try running manually to see errors: ACQATLAS_API_KEY=your_key npx @acqatlas-tools/mcp-server
• Check that npx is available in your PATH

First run is slow

The first time your AI client launches the server, npx downloads the @acqatlas-tools/mcp-server package. Subsequent launches use the cached version and start in under a second.