> ## Documentation Index
> Fetch the complete documentation index at: https://api.docs.dealmachine.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Use DealMachine with Claude Code, MCP servers, and other AI tools

# AI Assistants

DealMachine is designed to work with AI assistants. Use natural language to search properties, find contacts, and build targeted lists. The AI handles the filter logic for you.

## How It Works

```mermaid theme={null}
sequenceDiagram
    participant You
    participant Agent as Claude Code / AI Agent
    participant API as DealMachine API

    You->>Agent: "Find absentee owners in Austin with 40%+ equity"
    Agent->>API: GET /v1/filters and GET /v1/fields
    Agent->>Agent: Map description to filter config
    Agent->>API: POST /v1/properties/search
    API-->>Agent: Matching properties & contacts
    Agent-->>You: "Found 1,247 properties matching your criteria"
```

1. **You describe** what you're looking for in plain English
2. **The agent discovers** available filters and fields from the API
3. **The agent generates** the correct filter configuration
4. **The API returns** matching data
5. **You get results** without knowing the filter syntax

## Supported AI Tools

<CardGroup cols={2}>
  <Card title="Claude Code" icon="terminal" href="/ai-assistants/claude-code">
    Use the DealMachine CLI as a Claude Code skill. Search, filter, and export data from your terminal with natural language.
  </Card>

  <Card title="MCP Server" icon="server" href="/ai-assistants/mcp-server">
    Connect AI clients directly to DealMachine through the remote MCP server at `https://mcp.dealmachine.com`.
  </Card>
</CardGroup>

## Quick Example

### With Claude Code

```
You: Find all single family homes in Dallas, TX that are owned by
     absentee owners, have at least 50% equity, and were purchased
     more than 15 years ago.

Claude: I'll search DealMachine for those properties...

Found 892 properties matching:
- Property type: Single Family
- Location: Dallas, TX
- Absentee owner: Yes
- Equity: 50%+
- Years owned: 15+

Would you like me to export this list or refine the search?
```

### What You Can Do

| Action                | Description                                               |
| --------------------- | --------------------------------------------------------- |
| **Search properties** | "Find vacant lots in zip code 78701"                      |
| **Find contacts**     | "Get owners of commercial properties in downtown Austin"  |
| **Build lists**       | "Create a list of pre-foreclosure homes in Harris County" |
| **Check account**     | "How many credits do I have left this month?"             |
| **Export data**       | "Export these results to CSV"                             |

## Authentication for AI Tools

The CLI uses the API key stored by `dm login`:

```bash theme={null}
# Login once
dm login

# Credentials stored at ~/.dealmachine/config.json
# AI tools read from this automatically
```

The remote MCP server accepts a DealMachine API key as a Bearer token. OAuth-aware MCP clients can also discover authorization metadata from `https://mcp.dealmachine.com/.well-known/oauth-protected-resource`.