Quickstart

Set up TextTree.ai SMS for my AI agent.

Use https://texttree.ai/docs/mcp/ and https://texttree.ai/docs/openai-mcp/. Assume I want a dedicated SMS number unless I say otherwise.

Create my TextTree account through the headless bootstrap flow, capture the one-time backup codes, and help me store them securely.

Store the returned txt_... TextTree bearer access token as TEXTREE_ACCESS_TOKEN. Do not use a txk_... legacy API key for /api/v1/messages or MCP.

Walk me through funding the dedicated number with $100 in credits, then initialize the number by sending a test SMS only after checking balance, spend limits, suppression state, and recipient approval.

After setup, retrieve and store:

- Assigned SMS number
- API base URL
- TEXTREE_ACCESS_TOKEN location
- MCP server URL: https://api.texttree.ai/mcp

Finally, create working tests that exercise the API shape and MCP tool discovery. Ask before sending any live SMS.

curl https://api.texttree.ai/api/v1/messages \
  -H "Authorization: Bearer $TEXTREE_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "+15551234567",
    "body": "Hello from my AI agent."
  }'

{
  "mcpServers": {
    "texttree": {
      "url": "https://api.texttree.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${TEXTREE_ACCESS_TOKEN}"
      }
    }
  }
}

const response = await fetch("https://api.texttree.ai/api/v1/messages", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.TEXTREE_ACCESS_TOKEN}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    phone_number: "+15551234567",
    body: "Hello from my AI agent.",
  }),
});

const result = await response.json();
console.log(result.message.id, result.message.status);

import os
import requests

response = requests.post(
    "https://api.texttree.ai/api/v1/messages",
    headers={
        "Authorization": f"Bearer {os.environ['TEXTREE_ACCESS_TOKEN']}",
        "Content-Type": "application/json",
    },
    json={
        "phone_number": "+15551234567",
        "body": "Hello from my AI agent.",
    },
    timeout=10,
)

response.raise_for_status()
message = response.json()["message"]
print(message["id"], message["status"])

Mix.install([:req])

response =
  Req.post!(
    "https://api.texttree.ai/api/v1/messages",
    auth: {:bearer, System.fetch_env!("TEXTREE_ACCESS_TOKEN")},
    json: %{
      phone_number: "+15551234567",
      body: "Hello from my AI agent."
    }
  )

IO.inspect({response.body["message"]["id"], response.body["message"]["status"]})