@acqatlas-tools/mcp-server

MCP server for Acquisition Atlas — a live feed of county filings (tax liens, municipal liens, and more) matched to properties with extracted ownership, valuation, lien amounts, filing dates, and contact data. Connects AI assistants like Claude Desktop, Cursor, and Claude Code to the full platform — search filings, manage saved lists and deal alerts, track and share properties, manage your Buyers CRM, collaborate with teams, and analyze deals — all through natural language.

94 tools across 16 feature areas. No extra configuration — just your API key.

Quick Start

1. Get an API Key

Sign up and generate a key at app.acqatlas.com/settings/api.

2. Configure Your AI Client

Claude Desktop — add to claude_desktop_config.json:

{
  "mcpServers": {
    "acquisition-atlas": {
      "command": "npx",
      "args": ["-y", "@acqatlas-tools/mcp-server"],
      "env": {
        "ACQATLAS_API_KEY": "ak_live_your_key_here"
      }
    }
  }
}

Cursor — add to .cursor/mcp.json:

{
  "mcpServers": {
    "acquisition-atlas": {
      "command": "npx",
      "args": ["-y", "@acqatlas-tools/mcp-server"],
      "env": {
        "ACQATLAS_API_KEY": "ak_live_your_key_here"
      }
    }
  }
}

Claude Code — add to .mcp.json:

{
  "mcpServers": {
    "acquisition-atlas": {
      "command": "npx",
      "args": ["-y", "@acqatlas-tools/mcp-server"],
      "env": {
        "ACQATLAS_API_KEY": "ak_live_your_key_here"
      }
    }
  }
}

OpenClaw — add to ~/.openclaw/openclaw.json:

{
  "mcp": {
    "servers": {
      "acquisition-atlas": {
        "command": "npx",
        "args": ["-y", "@acqatlas-tools/mcp-server"],
        "env": {
          "ACQATLAS_API_KEY": "ak_live_your_key_here"
        }
      }
    }
  }
}

That's it — just your API key. The server automatically authenticates you on startup and enables all tools for your account.

3. Start Asking Questions

Filing data:

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

Saved lists & deal alerts:

• "Create a lead list called 'High Equity Targets'"
• "Set up a deal alert for Franklin County tax liens over $5,000"
• "Duplicate my Q1 Prospects list"

Track properties:

• "Favorite this property"
• "Mark this property as having an active deal"
• "Which of my lists contain this property?"

Buyers CRM:

• "Add John Smith as a fix-and-flip buyer with email [email protected]"
• "Which of my buyers match this tax lien property?"
• "Export all my buyer contacts as JSON"

Teams & sharing:

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

Available Tools (94)

The server provides up to 94 tools depending on your account. Public tools (11) are always available. Authenticated tools (83) activate automatically when the server verifies your identity on startup.

Filing Tools (8)

| 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)

| Tool | Description | |------|-------------| | get_lien_details | Full property details with ATTOM data (beds, baths, sqft, value, equity) | | get_related_liens | Find comparable/related properties | | get_property_comps | Sales comparables with aggregate price statistics |

Buyer CRM (17)

| Tool | Description | |------|-------------| | list_buyers | Search, filter, and paginate buyer contacts | | get_buyer | Full buyer details including tags | | create_buyer | Add a new buyer contact | | update_buyer | Update buyer fields (partial updates) | | delete_buyer | Remove a buyer and all related data | | get_buyer_stats | Dashboard stats | | manage_buyer_tags | CRUD operations on tags + assign/remove | | manage_buyer_notes | CRUD operations on notes | | log_buyer_activity | Log calls, emails, meetings | | manage_buy_boxes | Manage buy box criteria | | match_buyers_to_property | Score buyers against a property (0–100) | | manage_buyer_saved_filters | Save/list/delete filter presets | | export_buyers | Export buyer contacts as structured JSON | | manage_buyer_follow_ups | List, complete, reschedule, or delete buyer follow-ups | | manage_buyer_documents | Upload, list, and delete buyer documents (presigned S3 URLs) | | manage_buyer_images | Upload or set buyer profile images | | import_buyers | Import from CSV with field mapping and dedup (max 5,000 rows) |

Saved Lists (12)

| Tool | Description | |------|-------------| | list_saved_lists | List your saved lists with type filter and pagination | | get_saved_list | Get a list by ID with lead count | | get_saved_list_leads | Get properties in a list | | create_saved_list | Create static, dynamic, snapshot, or lead lists | | update_saved_list | Update name, description, filters, notifications | | delete_saved_list | Soft-delete a list | | duplicate_saved_list | Copy a list including all 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 lists contain a property? | | set_active_lead_list | Set your default lead list | | get_active_lead_list | Get your active lead list |

Deal Alerts (4)

| Tool | Description | |------|-------------| | get_alerts | Get all active deal alerts | | get_deal_alerts_status | Summary of alert configuration | | save_deal_alerts | Create or update a deal alert | | update_alert | Toggle notifications, change frequency/channels |

Lien Preferences (5)

| Tool | Description | |------|-------------| | toggle_lien_favorite | Toggle favorite on a property | | toggle_lien_archived | Toggle archived on a property | | mark_lien_has_deal | Flag a property as having a deal | | unmark_lien_has_deal | Remove the deal flag | | get_lien_preferences | Get preferences for one or more properties |

Teams (6)

| Tool | Description | |------|-------------| | list_teams | List teams you belong to | | get_team | Team details with members | | create_team | Create a new team | | get_team_shared_lists | Lists shared with a team | | share_list_with_team | Share a list with a team | | unshare_list_from_team | Unshare a list |

Sharing (3)

| Tool | Description | |------|-------------| | create_lien_share_link | Generate a shareable property link | | get_my_shared_links | List your shared links with analytics | | generate_list_share_link | Generate a shareable list link |

Notifications (4)

| Tool | Description | |------|-------------| | get_notifications | Get notifications with unread filter | | get_unread_notification_count | Count of unread notifications | | mark_notification_read | Mark one notification as read | | mark_all_notifications_read | Mark all as read |

Entity Search (6)

| Tool | Description | |------|-------------| | search_entity_by_name | Search for a business entity | | get_entity_search_status | Check search status | | get_entity_search_history | Your past entity searches | | get_business_lists | Your saved entity collections | | create_business_list | Save an entity search | | add_search_to_list | Link entity search to a saved list |

Deal Pipeline (17)

| Tool | Description | |------|-------------| | list_deals | Search, filter, and paginate deals | | get_deal | Full deal details with stage, financials, seller info | | create_deal | Create a new deal | | update_deal | Update deal fields (partial updates) | | delete_deal | Remove a deal | | 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 stages | | manage_deal_tags | CRUD operations on deal tags | | manage_deal_notes | CRUD operations on deal notes | | log_deal_activity | Log activity on a deal | | manage_deal_follow_ups | List, complete, reschedule, or delete deal follow-ups | | match_buyers_to_deal | Score buyers against a deal (0–100) | | get_deal_buyer_matches | Get/update buyer match results | | manage_deal_documents | Upload, list, delete deal documents (presigned S3 URLs) | | manage_deal_images | Upload or set deal property images |

Calendar (5)

| Tool | Description | |------|-------------| | get_calendar_events | Follow-ups in a date range (buyers + deals) | | 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)

| Tool | Description | |------|-------------| | list_agents | List agent/broker contacts | | manage_agent_buyer_profiles | Add, update, or remove buyer profiles |

Profile (2)

| Tool | Description | |------|-------------| | get_my_profile | Your user profile | | get_acquisition_profile | Your AI-learned investment preferences |

How Authentication Works

When the server starts, it calls GET /v1/me with your API key to verify your identity. If successful, all 94 tools are registered. If the key is invalid or the network is unavailable, only the 11 public tools are registered (filing data + enriched lien details).

No additional configuration is needed — your API key is all the server needs.

Available Resources

The server exposes the full API documentation as MCP resources so your AI can answer questions about the API:

| URI | Content | |-----|---------| | acqatlas://docs/intro | API introduction | | acqatlas://docs/quickstart | Getting started guide | | acqatlas://docs/authentication | API key authentication | | acqatlas://docs/endpoints/* | Endpoint references (9 endpoints) | | acqatlas://docs/response-format | Response format guide | | acqatlas://docs/field-reference | Complete field reference | | acqatlas://docs/rate-limits | Rate limits by tier | | acqatlas://docs/tier-comparison | Tier comparison | | acqatlas://docs/pricing | Pricing overview |

Requirements

• Node.js 18+
• An Acquisition Atlas API key

Links

• Full documentation
• Get API key
• API docs

License

MIT