Spectrum MCP server for AI agents

Let Claude, ChatGPT or your own agent read and act on Spectrum: 20 typed functions through one MCP server. No Spectrum API key needed.

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

Connect

Just Spectrum

An MCP server for Spectrum 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/spectrum
Every site

One MCP server for Spectrum 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
  • checkMobileCoverageSpectrum Mobile's network coverage at an address, city or ZIP, off the raster overlay spectrum.com/mobile/coverage-map renders (a third-party…

    Arguments

    NameTypeRequired
    locationstringYes

    Returns SpectrumMobileCoverage

    interface SpectrumMobileCoverage {
      location: string;
      lat: number;
      lng: number;
      covered: boolean;
      rasterAlpha: number;  // the site's own [0,255] raster alpha at the point, 0 is "No Coverage", 255 fully inside; see covered
      sourceUrl: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/spectrum/checkMobileCoverage

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.spectrum.checkMobileCoverage("Stamford, CT");
  • getAccountBalanceThe signed-in caller's current Spectrum account balance: amount due, due date and account status, off spectrum.net's account/billing area.

    Arguments

    None.

    Returns SpectrumAccountBalance

    interface SpectrumAccountBalance {
      accountNumberLast4: string | null;  // last four digits only, the full number is never returned
      totalAmountDue: number | null;
      paymentDueDate: string | null;
      paymentDueText: string | null;  // the bill's own due line, verbatim
      previousBalance: number | null;
      paymentsMade: number | null;
      unpaidBalance: number | null;
      autoPayDate: string | null;
      statementDate: string | null;
      statementId: string;  // the newest statement this balance was read from
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.spectrum.getAccountBalance();
  • getBillingHistoryThe signed-in caller's past Spectrum bills: period, amount and payment status.

    Arguments

    None.

    Returns SpectrumBillingHistory

    interface SpectrumPayment {
      date: string | null;
      amount: number | null;
      status: string | null;  // the site's own labels, read the values off a result, never guess one from prose
      paymentType: string | null;
      description: string | null;
      confirmationNumber: string | null;
    }
    
    interface SpectrumStatement {
      id: string;
      date: string | null;
    }
    
    interface SpectrumBillingHistory {
      payments: SpectrumPayment[];  // spectrum.net's own payment history, as its billing page lists it
      statements: SpectrumStatement[];  // the account's digital bill statements
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/spectrum/getBillingHistory

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.spectrum.getBillingHistory();
  • getByTheGigPlanSpectrum Mobile's pay-per-gig "By the Gig" plan (the one listMobilePlans leaves out), read off the JSON-LD of…

    Arguments

    None.

    Returns SpectrumByTheGigPlan

    interface SpectrumByTheGigPlan {
      name: string;
      description: string;
      monthlyPrice: number;  // what the first GB costs per month
      pricePerAdditionalGb: number | null;
      maxLines: number | null;
      sourceUrl: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/spectrum/getByTheGigPlan

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.spectrum.getByTheGigPlan();
  • getChannelLineupThe signed-in caller's Spectrum TV channel lineup for their own market.

    Arguments

    None.

    Returns SpectrumChannelLineup

    interface SpectrumChannel {
      name: string;
      channelNumber: string | null;  // guide number as shown, e.g. "1012"
      entitled: boolean;  // true when the caller's package includes it
      genres: string[];
      logoUrl: string | null;
      tmsId: string | null;  // Gracenote station id
    }
    
    interface SpectrumChannelLineup {
      channels: SpectrumChannel[];
      notices: string[];  // Spectrum's own lineup-change notices, in order
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/spectrum/getChannelLineup

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.spectrum.getChannelLineup();
  • getEquipmentStatusThe signed-in caller's Spectrum equipment (modem, router, WiFi pods, TV boxes) with each device's connection state, model, ownership and firmware…

    Arguments

    None.

    Returns SpectrumEquipment[]

    interface SpectrumWifiNetwork {
      ssid: string | null;
      securityMode: string | null;
      bands: string[];
    }
    
    interface SpectrumPodHealth {
      score: number | null;
      status: string | null;  // the site's own labels, read the values off a result, never guess one from prose
      connectedDeviceCount: number | null;
    }
    
    interface SpectrumEquipment {
      id: string | null;
      connectionState: string | null;  // the site's own label, read values off a result, never guess one
      equipmentType: string | null;
      categories: string[];
      linesOfBusiness: string[];
      manufacturer: string | null;
      model: string | null;
      nickname: string | null;
      ownership: string | null;
      serialNumber: string | null;
      firmwareVersion: string | null;
      macAddress: string | null;
      wifiNetworks: SpectrumWifiNetwork[];  // network names the router broadcasts, never the passwords
      podHealth: SpectrumPodHealth | null;  // set only for a WiFi pod/extender
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/spectrum/getEquipmentStatus

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.spectrum.getEquipmentStatus();
  • getInternetPlanDetailsOne Gig-tier internet plan's own detail page at spectrum.com/internet/plans/internet-gig: download speed, connection type, included WiFi equipment…

    Arguments

    NameTypeRequired
    planNamestringYes

    Returns SpectrumInternetPlanDetails

    interface SpectrumInternetPlanDetails {
      name: string;
      downloadMbps: number;
      connection: string;
      wifiIncluded: string;
      idealFor: string;
      advertisedMonthlyPrice: number;
      standardMonthlyPrice: number | null;
      sourceUrl: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/spectrum/getInternetPlanDetails

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.spectrum.getInternetPlanDetails("Internet 1 Gig");
  • getOutageStatusEvery open outage or maintenance event on the signed-in caller's Spectrum account.

    Arguments

    None.

    Returns SpectrumOutage[]

    interface SpectrumOutage {
      id: string | null;
      problemType: string | null;  // spectrum.net's own type, verbatim
      servicesAffected: string[];
      status: string | null;  // the site's own labels, read the values off a result, never guess one from prose
      startedAt: string | null;
      estimatedResolution: string | null;  // estimated restoration time; null when none given
      cause: string | null;
      message: string | null;
      creditEligible: boolean | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/spectrum/getOutageStatus

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.spectrum.getOutageStatus();
  • getUsageSummaryThe signed-in caller's Spectrum Mobile usage for the current bill cycle (data, minutes, messages per line), off spectrum.net's own account GraphQL.

    Arguments

    None.

    Returns SpectrumUsageCycle[]

    interface SpectrumLineUsage {
      lineId: string | null;
      planName: string | null;
      dataTotal: number | null;  // data used this cycle, as spectrum.net reports it
      minutesTotal: number | null;
      messagesTotal: number | null;
    }
    
    interface SpectrumUsageCycle {
      cycleStartDate: string | null;
      cycleEndDate: string | null;
      lines: SpectrumLineUsage[];  // one row per Spectrum Mobile line
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/spectrum/getUsageSummary

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.spectrum.getUsageSummary();
  • listInternetPlansEvery residential internet-only plan Spectrum advertises on spectrum.com/internet/plans.

    Arguments

    None.

    Returns SpectrumInternetPlan[]

    interface SpectrumInternetPlan {
      name: string;
      downloadMbps: number;
      advertisedMonthlyPrice: number;
      availability: string | null;  // the site's own labels, read the values off a result, never guess one from prose
      sourceUrl: string;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.spectrum.listInternetPlans();
  • listMobileDealsCurrent Spectrum Mobile device and line promotions on spectrum.com/mobile/mobile-deals.

    Arguments

    None.

    Returns SpectrumMobileDeal[]

    interface SpectrumMobileDeal {
      device: string;
      requirement: string;
      discountAmount: number | null;
      sourceUrl: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/spectrum/listMobileDeals

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.spectrum.listMobileDeals();
  • listMobilePlansThe three Spectrum Mobile "Unlimited" plans on spectrum.com/mobile/plans (Unlimited, Unlimited Plus, Unlimited Plus Premium).

    Arguments

    None.

    Returns SpectrumMobilePlan[]

    interface SpectrumMobilePlan {
      name: string;
      description: string;
      monthlyPricePerLine: number;
      firstLineIntroPrice: number | null;
      deviceCredit: string | null;
      highlights: string[];  // the site's own bullet lines, read the values off a result, never guess one from prose
      sourceUrl: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/spectrum/listMobilePlans

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.spectrum.listMobilePlans();
  • listServiceAppointmentsThe signed-in caller's Spectrum technician visits with time window, status, reason, whether each can be cancelled or rescheduled, and the live…

    Arguments

    None.

    Returns SpectrumAppointmentListing[]

    interface SpectrumAppointmentListing {
      id: string | null;
      status: string | null;  // the site's own labels, read the values off a result, never guess one from prose
      orderClass: string | null;
      workOrderType: string | null;
      reasonCodes: string[];
      startTime: string | null;
      endTime: string | null;
      timezone: string | null;
      past: boolean | null;
      cancelAllowed: boolean | null;
      rescheduleAllowed: boolean | null;
      technicianTrackingUrl: string | null;  // live "where is my technician" link
      createdAt: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/spectrum/listServiceAppointments

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.spectrum.listServiceAppointments();
  • listTvAddOnsEvery premium channel Spectrum TV sells as an add-on, read off spectrum.com/cable-tv/premium-channels (Paramount+ with Showtime, HBO Max, Starz &…

    Arguments

    None.

    Returns SpectrumTvAddOn[]

    interface SpectrumTvAddOn {
      name: string;
      description: string;
      monthlyPrice: number | null;
      sourceUrl: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/spectrum/listTvAddOns

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.spectrum.listTvAddOns();
  • listTvPlansEvery Spectrum TV package on spectrum.com/cable-tv/plans.

    Arguments

    None.

    Returns SpectrumTvPlan[]

    interface SpectrumTvPlan {
      name: string;
      channelCount: number | null;
      promotionalMonthlyPrice: number | null;
      standardMonthlyPrice: number;
      sourceUrl: string;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.spectrum.listTvPlans();
  • rescheduleServiceAppointmentMove one of the signed-in caller's Spectrum technician visits to another window, through spectrum.net's own account GraphQL.

    Arguments

    NameTypeRequired
    appointmentIdstring
    The id listServiceAppointments returns.
    Yes
    scheduleDatestring
    YYYY-MM-DD, from the windows list; pass with scheduleTimeCode to move the visit.
    No
    scheduleTimeCodestringNo
    scheduleTimestring
    The window's own label; looked up when omitted.
    No

    Returns SpectrumAppointmentReschedule

    interface SpectrumAppointmentReschedule {
      rescheduled: boolean;
      appointmentId: string;
      message: string | null;
      availableWindows: { scheduleDate: string | null; scheduleTime: string | null; scheduleTimeCode: string | null; startTimestamp: string | null; endTimestamp: string | null }[];  // set when no window was chosen
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/spectrum/rescheduleServiceAppointment

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.spectrum.rescheduleServiceAppointment({ appointmentId: "<appointmentId>" });
  • restartEquipmentRestart the signed-in caller's Spectrum modem (or another device by equipmentId) remotely through spectrum.net's own account GraphQL, the same call…

    Arguments

    NameTypeRequired
    equipmentIdstring
    From getEquipmentStatus; omit to restart the account's one modem.
    No

    Returns SpectrumEquipmentRestart

    interface SpectrumEquipmentRestart {
      equipmentId: string;
      restarted: boolean;
      expectedBackInSeconds: number | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/spectrum/restartEquipment

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.spectrum.restartEquipment({});
Act 3
  • cancelServiceAppointmentCancel one of the signed-in caller's Spectrum technician visits, by the appointmentId listServiceAppointments returns, through spectrum.net's own…

    Arguments

    NameTypeRequired
    appointmentIdstring
    The id listServiceAppointments returns.
    Yes

    Returns SpectrumAppointmentCancellation

    interface SpectrumAppointmentCancellation {
      appointmentId: string;
      cancelled: boolean;
      message: string | null;  // spectrum.net's own message, when it sends one
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/spectrum/cancelServiceAppointment

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.spectrum.cancelServiceAppointment({ appointmentId: "<appointmentId>" });
  • scheduleServiceAppointmentBook a Spectrum technician visit for the signed-in caller's internet (down or slow), from spectrum.net's own appointment flow: list the open windows…

    Arguments

    NameTypeRequired
    reason"internetOut" | "internetSlow"
    Why the technician is coming.
    Yes
    scheduleDatestring
    YYYY-MM-DD, from a window this function listed.
    No
    scheduleTimeCodestring
    E.g. "11AMTO1PM", from the same window.
    No

    Returns SpectrumServiceAppointment

    interface SpectrumAppointmentWindow {
      scheduleDate: string | null;
      scheduleTime: string | null;  // e.g. "11AM - 1PM"
      scheduleTimeCode: string | null;
      startTimestamp: string | null;
      endTimestamp: string | null;
    }
    
    interface SpectrumBookedAppointment {
      apptId: string | null;
      jobNumber: string | null;
      startTime: string | null;
      endTime: string | null;
      timezone: string | null;
      status: string | null;  // the site's own labels, read the values off a result, never guess one from prose
      workOrderType: string | null;
      reasonCodes: string[];
      rescheduleAllowed: boolean | null;
      cancelAllowed: boolean | null;
    }
    
    interface SpectrumServiceAppointment {
      booked: boolean;  // false when only listing windows
      appointment: SpectrumBookedAppointment | null;  // set when booked
      availableWindows: SpectrumAppointmentWindow[];  // set when no window was chosen
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/spectrum/scheduleServiceAppointment

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.spectrum.scheduleServiceAppointment({ reason: "internetOut" });
  • updateWifiNetworkChange the signed-in caller's Spectrum home WiFi network name and password in one step, on every band, through spectrum.net's own account GraphQL.

    Arguments

    NameTypeRequired
    ssidstring
    New network name, 1-32 characters.
    Yes
    passwordstring
    New WPA2 passphrase, 8-63 characters.
    Yes
    equipmentIdstring
    The router's id from getEquipmentStatus; optional when the account has one router.
    No

    Returns SpectrumWifiUpdate

    interface SpectrumWifiAccessPoint {
      id: string | null;
      ssid: string | null;
      securityMode: string | null;
      bands: string[];  // e.g. "2.4GHz", "5GHz"
    }
    
    interface SpectrumWifiUpdate {
      equipmentId: string | null;
      wifiNetworks: SpectrumWifiAccessPoint[];  // what the router reports after the change, never the password
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/spectrum/updateWifiNetwork

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.spectrum.updateWifiNetwork({ ssid: "<ssid>", password: "<password>" });

Use it from code