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.
- Site
- att.com
- Functions
- 17
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
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/attOne 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/mcpSet it up in your clientBoth 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.
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
Name Type Required 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/findDevicesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.att.findDevices("iphone");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.att.findDevices("iphone"))curl -X POST https://api.bowmark.ai/v1/sites/att/findDevices \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"iphone"}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required 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/findStoresCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.att.findStores("10001");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.att.findStores("10001"))curl -X POST https://api.bowmark.ai/v1/sites/att/findStores \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"location":"10001"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.att.findStores("10001");getAccountBalanceThe signed-in caller's current AT&T account balance.Arguments
None.
Returns
AttAccountBalanceinterface AttAccountBalance { amountDueUsd: number | null; dueDate: string | null; accountStatus: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/att/getAccountBalanceCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.att.getAccountBalance();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.att.getAccountBalance())curl -X POST https://api.bowmark.ai/v1/sites/att/getAccountBalance \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required devicestringYes Returns
AttDevicePricinginterface 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/getDevicePricingCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.att.getDevicePricing("iPhone 16 Pro");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.att.getDevicePricing("iPhone 16 Pro"))curl -X POST https://api.bowmark.ai/v1/sites/att/getDevicePricing \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"device":"iPhone 16 Pro"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.att.getDevicePricing("iPhone 16 Pro");getMonthlyBillA specific month's bill: total due, due date, and auto-pay status.Arguments
Name Type Required monthstringNo Returns
AttMonthlyBillinterface 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/getMonthlyBillCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.att.getMonthlyBill();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.att.getMonthlyBill())curl -X POST https://api.bowmark.ai/v1/sites/att/getMonthlyBill \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required devicestringYes condition{ powersOn?: boolean; activationLockOff?: boolean; screenIntact?: boolean }No Returns
AttTradeInQuoteinterface 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/getTradeInQuoteCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.att.getTradeInQuote("iPhone 14 128GB", { screenIntact: false });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.att.getTradeInQuote("iPhone 14 128GB", {"screenIntact": False}))curl -X POST https://api.bowmark.ai/v1/sites/att/getTradeInQuote \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"device":"iPhone 14 128GB","condition":{"screenIntact":false}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required 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/getTradeInValueCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.att.getTradeInValue("iPhone 14");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.att.getTradeInValue("iPhone 14"))curl -X POST https://api.bowmark.ai/v1/sites/att/getTradeInValue \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"device":"iPhone 14"}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required lineIdstringNo Returns
AttLineUsageinterface 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/getUsageCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.att.getUsage();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.att.getUsage())curl -X POST https://api.bowmark.ai/v1/sites/att/getUsage \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return 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/listDealsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.att.listDeals();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.att.listDeals())curl -X POST https://api.bowmark.ai/v1/sites/att/listDeals \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return 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/listInternetPlansCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.att.listInternetPlans();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.att.listInternetPlans())curl -X POST https://api.bowmark.ai/v1/sites/att/listInternetPlans \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return 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/listLinesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.att.listLines();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.att.listLines())curl -X POST https://api.bowmark.ai/v1/sites/att/listLines \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return 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/listPlansCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.att.listPlans();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.att.listPlans())curl -X POST https://api.bowmark.ai/v1/sites/att/listPlans \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return 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/listPrepaidPlansCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.att.listPrepaidPlans();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.att.listPrepaidPlans())curl -X POST https://api.bowmark.ai/v1/sites/att/listPrepaidPlans \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required 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/listTabletsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.att.listTablets("ipad");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.att.listTablets("ipad"))curl -X POST https://api.bowmark.ai/v1/sites/att/listTablets \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"ipad"}'// The body of a run: the MCP run tool, or POST /v1/run return 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/listTvPlansCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.att.listTvPlans();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.att.listTvPlans())curl -X POST https://api.bowmark.ai/v1/sites/att/listTvPlans \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.att.listTvPlans();viewBillHistoryThe caller's past 12 months of bills: month, amount due, amount paid, payment date.Arguments
Name Type Required 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/viewBillHistoryCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.att.viewBillHistory();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.att.viewBillHistory())curl -X POST https://api.bowmark.ai/v1/sites/att/viewBillHistory \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required 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/viewOrderHistoryCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.att.viewOrderHistory();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.att.viewOrderHistory())curl -X POST https://api.bowmark.ai/v1/sites/att/viewOrderHistory \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.att.viewOrderHistory();
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/att/<function> - OpenAPI
/v1/sites/att/openapi.json