AT&T MCP server for AI agents

Let Claude, ChatGPT or your own agent read AT&T: 17 typed functions through one MCP server. No AT&T API key needed.

Functions
17
Sign-in
For account actions
Works with
MCP, HTTP, Node, Python

Connect

Just AT&T

An MCP server for AT&T alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.

https://api.bowmark.ai/mcp/site/att
Every site

One MCP server for AT&T and every other site Bowmark covers. Your agent looks up what it needs and calls it.

https://api.bowmark.ai/mcp
Set it up in your client

Both need a Bowmark API key. The quickstart gets you one and a first result in a few minutes. Functions that need a login use the person's own account: how sign-in works.

Functions

Open a function to see its arguments, what it returns and how to call it.

Read 17
  • findDevicesEvery phone on AT&T's own phones listing (att.com/buy/phones/) - name, brand, product page URL and headline price, narrowed by a query.

    Arguments

    NameTypeRequired
    querystringNo

    Returns AttDevice[]

    interface AttDevice {
      name: string;                  // "Apple iPhone 16 Pro"
      brand: string | null;
      url: string;                   // the product page getDevicePricing takes
      listedPriceUsd: number | null; // listing headline: monthly installment, or full price
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/att/findDevices

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.att.findDevices("iphone");
  • findStoresAT&T stores near a US ZIP or "city, state", nearest first, off AT&T's own store locator: name, address, phone, store page URL, distance, whether AT&T…

    Arguments

    NameTypeRequired
    locationstringYes
    options{ limit?: number; radiusMiles?: number }No

    Returns AttStore[]

    interface AttStore {
      id: string;
      name: string;
      address: string;
      city: string | null;
      state: string | null;
      postalCode: string | null;
      phone: string | null;
      url: string | null;
      latitude: number | null;
      longitude: number | null;
      distanceMiles: number | null;
      companyOwned: boolean; // false = an authorized retailer
      hours: Record<
        "monday" | "tuesday" | "wednesday" | "thursday" | "friday" | "saturday" | "sunday",
        string | null
      >; // "09:00-20:00"
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/att/findStores

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.att.findStores("10001");
  • getAccountBalanceThe signed-in caller's current AT&T account balance.

    Arguments

    None.

    Returns AttAccountBalance

    interface AttAccountBalance {
      amountDueUsd: number | null;
      dueDate: string | null;
      accountStatus: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/att/getAccountBalance

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.att.getAccountBalance();
  • getDevicePricingAT&T's current device price and financing for a phone (e.g. iPhone 16 Pro): full retail price, AT&T Installment Plan term and monthly payment, Next…

    Arguments

    NameTypeRequired
    devicestringYes

    Returns AttDevicePricing

    interface AttDeviceVariant {
      skuId: string; name: string; capacity: string | null; color: string | null;
      inStock: boolean | null;
      priced: boolean;               // false = AT&T's page did not carry this variant's prices
      fullRetailPriceUsd: number | null;
      installment: { planName: string; termMonths: number; monthlyUsd: number; totalUsd: number } | null;
      nextUpAnytimeMonthlyUsd: number | null;
      portInDiscountUsd: number | null;
      promotions: Array<{ type: string; monthlyPromoPriceUsd: number | null; tradeInCreditUsd: number | null }>;
    }
    
    interface AttDevicePricing {
      url: string; name: string; manufacturer: string | null;
      variants: AttDeviceVariant[];  // priced variants first
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/att/getDevicePricing

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.att.getDevicePricing("iPhone 16 Pro");
  • getMonthlyBillA specific month's bill: total due, due date, and auto-pay status.

    Arguments

    NameTypeRequired
    monthstringNo

    Returns AttMonthlyBill

    interface AttMonthlyBill {
      month: string | null; totalDueUsd: number | null; dueDate: string | null;
      autoPay: boolean | null;
      charges: Array<{ label: string; amountUsd: number }>; // always empty, see getMonthlyBill
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/att/getMonthlyBill

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.att.getMonthlyBill();
  • getTradeInQuoteWhat AT&T pays for this phone in its condition (powers on, activation lock off, screen intact), off AT&T's own trade-in tool: the condition-adjusted…

    Arguments

    NameTypeRequired
    devicestringYes
    condition{ powersOn?: boolean; activationLockOff?: boolean; screenIntact?: boolean }No

    Returns AttTradeInQuote

    interface AttTradeInQuote {
      modelCode: string; // "2380451"
      name: string; // "iPhone 14 128GB"
      valueUsd: number; // what AT&T pays in THIS condition: 90 for a cracked iPhone 14 128GB
      baseValueUsd: number | null; // the value before the condition questions: 180
      answers: { question: string; code: string; answer: string }[]; // the condition answers sent
      promotions: { description: string; code: string; billCreditUsd: number | null }[]; // new-phone promos, top 20 by credit
      promotionCount: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/att/getTradeInQuote

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.att.getTradeInQuote("iPhone 14 128GB", { screenIntact: false });
  • getTradeInValueWhat an old phone is worth toward AT&T, off AT&T's own trade-in tool (tradein.att.com): matching models with their trade-in value in USD before…

    Arguments

    NameTypeRequired
    devicestringYes
    options{ limit?: number }No

    Returns AttTradeInValue[]

    interface AttTradeInValue {
      modelCode: string; // HYLA's id for the model, "2380451"
      name: string; // "iPhone 14 128GB"
      manufacturer: string | null; // "Apple"
      family: string | null; // "iPhone 14"
      capacity: string | null; // "128GB"
      valueUsd: number | null; // the value before condition questions; 0 means recycle only
      recycleOnly: boolean;
      imageUrl: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/att/getTradeInValue

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.att.getTradeInValue("iPhone 14");
  • getUsageData and voice usage on a line: current month's data used (MB/GB), talk minutes used, text messages sent, and usage limits for each.

    Arguments

    NameTypeRequired
    lineIdstringNo

    Returns AttLineUsage

    interface AttLineUsage {
      lineId: string | null;
      dataUsedGb: number | null; dataLimitGb: number | null;
      talkMinutesUsed: number | null; textsSent: number | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/att/getUsage

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.att.getUsage();
  • listDealsThe current offers on AT&T's own deals page (att.com/deals/): headline, audience, condition line, shop URL and which row of the page it sits in.

    Arguments

    None.

    Returns AttDeal[]

    interface AttDeal {
      section: string; // "featured" | "top" | "bundles" | "accessories"
      audience: string | null; // "New & existing customers"
      title: string;
      description: string | null;
      url: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/att/listDeals

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.att.listDeals();
  • listInternetPlansEvery AT&T Fiber home-internet speed tier on AT&T's own fiber page (att.com/internet/fiber/): tier name ("AT&T Internet 1000"), speed in AT&T's words…

    Arguments

    None.

    Returns AttInternetPlan[]

    interface AttInternetPlan {
      name: string; // "AT&T Internet 1000"
      speed: string; // AT&T's words: "Up to 1 GIG speed"
      speedMbps: number | null;
      monthlyUsd: number | null; // offer price on its own
      regularMonthlyUsd: number | null; // the struck-through price
      withWirelessMonthlyUsd: number | null; // offer price bundled with an AT&T wireless plan
      perks: string[]; // "$100 reward card", "3 months of YouTube TV on us"
      features: string[]; // "Level up your gaming with low lag.", "Support your smart home devices."
      shopUrl: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/att/listInternetPlans

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.att.listInternetPlans();
  • listLinesEvery line on the caller's AT&T account: phone number, device, plan name, upgrade eligibility, and line ID for use with other functions like getUsage.

    Arguments

    None.

    Returns AttLine[]

    interface AttLine {
      lineId: string; phoneNumber: string | null; device: string | null;
      planName: string | null; upgradeEligible: boolean | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/att/listLines

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.att.listLines();
  • listPlansEvery unlimited wireless plan on AT&T's own plan-picker page (att.com/plans/unlimited-data-plans/): name, headline data feature in AT&T's own words…

    Arguments

    None.

    Returns AttPlan[]

    interface AttPlanLinePrice { lines: number; monthlyUsd: number }
    
    interface AttPlan {
      name: string; dataDescription: string | null;
      pricePerLineUsd: AttPlanLinePrice[];  // ascending by line count
      international: { included: boolean; note: string | null };
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/att/listPlans

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.att.listPlans();
  • listPrepaidPlansEvery AT&T Prepaid plan on AT&T's own prepaid plans page (att.com/prepaid/plans/): name, monthly price (with any prepay condition, e.g. the 12-month…

    Arguments

    None.

    Returns AttPrepaidPlan[]

    interface AttPrepaidPlan {
      name: string;                  // "Unlimited Saver"
      monthlyUsd: number | null;     // the headline monthly price
      pricesUsd: number[];           // every price the card shows, in AT&T's order
      priceNote: string | null;      // a condition on the price: "When you prepay $240"
      features: string[];            // the card's feature list, AT&T's own words, the site's own labels, read the values off a result, never guess one from prose
      shopUrl: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/att/listPrepaidPlans

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.att.listPrepaidPlans();
  • listTabletsEvery tablet on AT&T's own tablets listing (att.com/buy/tablets/): iPads, Galaxy Tabs, TCL and amiGO tablets with name, brand, product page URL and…

    Arguments

    NameTypeRequired
    querystringNo

    Returns AttDevice[]

    interface AttDevice {
      name: string;                  // "Apple iPhone 16 Pro"
      brand: string | null;
      url: string;                   // the product page getDevicePricing takes
      listedPriceUsd: number | null; // listing headline: monthly installment, or full price
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/att/listTablets

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.att.listTablets("ipad");
  • listTvPlansEvery AT&T TV package on AT&T's own TV page (att.com/tv/): streaming (ENTERTAINMENT, CHOICE, ULTIMATE, PREMIER), satellite and Spanish-language…

    Arguments

    None.

    Returns AttTvPlan[]

    interface AttTvPlan {
      id: string;                    // "ATT_TV_CHOICE"
      name: string;                  // "CHOICE"
      kind: string;                  // "streaming" | "satellite" | "genre-pack" | "mini-pack" | "free"
      channels: number | null;
      monthlyUsd: number | null;     // null for base packages: AT&T prices them live per address
      regularMonthlyUsd: number | null; // "curr. $94.99/mo." fine print, when it names the package
      shopUrl: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/att/listTvPlans

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.att.listTvPlans();
  • viewBillHistoryThe caller's past 12 months of bills: month, amount due, amount paid, payment date.

    Arguments

    NameTypeRequired
    limitnumberNo

    Returns AttBillHistoryEntry[]

    interface AttBillHistoryEntry {
      month: string | null; amountDueUsd: number | null;
      amountPaidUsd: number | null; paymentDate: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/att/viewBillHistory

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.att.viewBillHistory();
  • viewOrderHistoryThe caller's past device and accessory orders from AT&T: order date, items, tracking number, delivery status, and order total.

    Arguments

    NameTypeRequired
    limitnumberNo

    Returns AttOrder[]

    interface AttOrder {
      orderDate: string | null; items: string[]; trackingNumber: string | null;
      deliveryStatus: string | null; orderTotalUsd: number | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/att/viewOrderHistory

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.att.viewOrderHistory();

Use it from code