Copy# If you have the AlifOffice CLI installed and already ran `ao auth login`,
# the MCP server will read your key from ~/.ao/config automatically.
{
  "mcpServers": {
    "alifoffice": {
      "command": "ao-mcp"
    }
  }
}

Copyimport OpenAI from "openai";

const AO_KEY     = "ao_your_key_here";
const AO_WS      = "your-workspace-slug";
const AO_URL     = "https://www.alifoffice.com/api/v1";
const AO_HEADERS = { Authorization: `Bearer ${AO_KEY}`, "X-Workspace": AO_WS };

// 1. Fetch tool schema
const { tools } = await fetch(`${AO_URL}/tools`).then(r => r.json());

// 2. Chat with tools
const client   = new OpenAI();
const response = await client.chat.completions.create({
  model: "gpt-4o",
  tools,
  messages: [{ role: "user", content: "Show me unpaid invoices" }],
});

// 3. Execute tool calls
for (const call of response.choices[0].message.tool_calls ?? []) {
  const args = JSON.parse(call.function.arguments);
  const url  = `${AO_URL}/invoice/invoices?` + new URLSearchParams(args);
  const data = await fetch(url, { headers: AO_HEADERS }).then(r => r.json());
  console.log(data);
}

Copy# Fetch the full OpenAI-compatible tool schema
curl https://www.alifoffice.com/api/v1/tools | jq '.tools[].function.name'

# Output:
# "ao_auth_me"
# "ao_crm_contact_list"
# "ao_crm_contact_create"
# "ao_crm_deal_list"
# "ao_projects_list"
# "ao_projects_task_list"
# ... 19 tools total

Copyimport Anthropic from "@anthropic-ai/sdk";

const AO_KEY  = "ao_your_key_here";
const AO_WS   = "your-workspace-slug";
const AO_URL  = "https://www.alifoffice.com/api/v1";

// 1. Fetch Anthropic-format tools
const { tools } = await fetch(`${AO_URL}/tools?format=anthropic`).then(r => r.json());

// 2. Create message
const client  = new Anthropic();
const message = await client.messages.create({
  model: "claude-opus-4-6",
  max_tokens: 1024,
  tools,
  messages: [{ role: "user", content: "List all my active projects" }],
});

// 3. Execute tool calls
for (const block of message.content) {
  if (block.type === "tool_use") {
    const resp = await fetch(`${AO_URL}/projects?` + new URLSearchParams(block.input), {
      headers: { Authorization: `Bearer ${AO_KEY}`, "X-Workspace": AO_WS }
    }).then(r => r.json());
    console.log(resp.data);
  }
}

Copyimport requests

class AoClient:
    def __init__(self, api_key, workspace, base="https://www.alifoffice.com/api/v1"):
        self.base    = base
        self.headers = {
            "Authorization": f"Bearer {api_key}",
            "X-Workspace":   workspace,
            "Content-Type":  "application/json",
        }

    def get(self, path, **params):
        return requests.get(f"{self.base}/{path}", headers=self.headers, params=params).json()

    def post(self, path, **body):
        return requests.post(f"{self.base}/{path}", headers=self.headers, json=body).json()

    def patch(self, path, **body):
        return requests.patch(f"{self.base}/{path}", headers=self.headers, json=body).json()

ao = AoClient("ao_your_key_here", "your-workspace-slug")

# Examples
projects  = ao.get("projects", status="active")
new_task  = ao.post("projects/{id}/tasks", title="Fix bug", priority="high")
contacts  = ao.get("crm/contacts", search="acme corp", limit=10)
deal      = ao.post("crm/deals", title="Enterprise deal", amount=50000, stage="proposal")

Copyfrom langchain.tools import tool
import requests

AO_KEY = "ao_your_key_here"
AO_WS  = "your-workspace-slug"
HDRS   = {"Authorization": f"Bearer {AO_KEY}", "X-Workspace": AO_WS}
BASE   = "https://www.alifoffice.com/api/v1"

@tool
def list_projects(status: str = None) -> dict:
    """List AlifOffice projects. Optionally filter by status."""
    params = {"status": status} if status else {}
    return requests.get(f"{BASE}/projects", headers=HDRS, params=params).json()

@tool
def create_task(project_id: str, title: str, priority: str = "medium") -> dict:
    """Create a task in an AlifOffice project."""
    return requests.post(f"{BASE}/projects/{project_id}/tasks",
        headers={**HDRS, "Content-Type": "application/json"},
        json={"title": title, "priority": priority}).json()

@tool
def list_contacts(search: str = None) -> dict:
    """Search CRM contacts by name, email, or company."""
    return requests.get(f"{BASE}/crm/contacts", headers=HDRS,
        params={"search": search} if search else {}).json()

# Use with any LangChain agent
from langchain.agents import initialize_agent, AgentType
from langchain_openai import ChatOpenAI

agent = initialize_agent(
    tools=[list_projects, create_task, list_contacts],
    llm=ChatOpenAI(model="gpt-4o"),
    agent=AgentType.OPENAI_FUNCTIONS,
)
agent.run("List active projects and create a task in the first one: Write unit tests")