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

# Connector tools

> The three tools Lawtte exposes to Claude, and what each returns.

## place\_call

Places one outbound AI phone call for your firm.

<ParamField body="name" type="string" required>
  Who is being called, as the agent should address them. 1–120 characters.
</ParamField>

<ParamField body="phone" type="string" required>
  The recipient's US phone number. Normalized to E.164 before dialing.
</ParamField>

<ParamField body="objective" type="string" required>
  What the call should accomplish, in plain language. Up to 1,000 characters.
</ParamField>

<ParamField body="context" type="string">
  Background the agent may use — matter type, what was last discussed. Up to 4,000
  characters.
</ParamField>

<ParamField body="dry_run" type="boolean">
  Run every check and return what would happen, without dialing. Use this first.
</ParamField>

<Warning>
  This tool is marked destructive: it dials a real person and consumes Studio
  minutes. Claude asks you to confirm the name, number, and objective first.
</Warning>

Blocked attempts return the reason rather than failing silently — a number on the
Do Not Call list, a repeat within two hours, the daily cap, or a time outside the
calling window.

## get\_call\_result

Reads the status and outcome of one call placed through your connector.

<ParamField body="call_id" type="string" required>
  The ID returned by `place_call`.
</ParamField>

<ResponseField name="status" type="string">
  One of `blocked`, `dialing`, `in_progress`, `completed`, or `failed`.
</ResponseField>

<ResponseField name="objective_met" type="string">
  `yes`, `no`, or `partial`, from post-call analysis.
</ResponseField>

<ResponseField name="summary" type="string">
  A two-sentence summary of what happened on the call.
</ResponseField>

<ResponseField name="next_step" type="string">
  What the agent believes should happen next.
</ResponseField>

<ResponseField name="do_not_call" type="boolean">
  True when the person asked not to be called again. Lawtte records this and stops
  contacting the number.
</ResponseField>

Results arrive by signed webhook after the call ends, so a call asked about
immediately may still read `in_progress`.

## list\_calls

Lists up to 20 recent calls placed through your firm's connector.

<ParamField body="since" type="string">
  ISO 8601 timestamp with an offset. Only calls after this time are returned.
</ParamField>

<ParamField body="status" type="string">
  Filter by `blocked`, `dialing`, `in_progress`, `completed`, or `failed`.
</ParamField>

<Note>
  JSON schemas and error semantics for these tools are in the
  [MCP server reference](/mcp/server).
</Note>

<Note>
  Both read tools are scoped to the Studio account you approved. They never return
  calls from another firm, or calls placed outside the connector.
</Note>


## Related topics

- [Protocol reference](/mcp/server.md)
- [Connect Claude](/mcp/connect-claude.md)
- [Authentication](/authentication.md)
- [Troubleshooting](/mcp/troubleshooting.md)
- [Claude Desktop (macOS)](/mcp/claude-desktop.md)