Visible MCP server for AI agents

Let Claude, ChatGPT or your own agent read Visible: 5 typed functions through one MCP server. No Visible API key needed.

Functions
5
Sign-in
Not needed
Works with
MCP, HTTP, Node, Python

Connect

Just Visible

An MCP server for Visible 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/visible
Every site

One MCP server for Visible 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

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

Read 5
  • checkCoverageReturns Visible's network coverage at a caller-supplied address or ZIP, broken down by the tier that actually determines usable speed.

    Arguments

    NameTypeRequired
    addressOrZipstringYes

    Returns VisibleCheckCoverageResult

    interface VisibleCoveragePoint {
      matchedAddress: string | null;
      city: string | null;
      state: string | null;
      zip: string | null;
      latitude: number;
      longitude: number;
    }
    
    interface VisibleCheckCoverageResult {
      input: string;
      point: VisibleCoveragePoint;
      tier: "5gUltraWideband" | "5gNationwide" | "4gLte" | "none";
      fiveGUltraWideband: boolean;
      fiveGNationwide: boolean;
      fourGLte: boolean;
    
      summary: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/visible/checkCoverage

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.visible.checkCoverage("1600 Pennsylvania Ave NW, Washington, DC 20500");
  • getPhoneReturns one device Visible sells, in full, from its catalogue URL or product id.

    Arguments

    NameTypeRequired
    slugOrUrlstringYes
    options{ preOwned?: boolean }No

    Returns VisibleGetPhoneResult

    interface VisiblePhoneVariant {
      sku: string;
      storage: string | null;
      color: string | null;
      condition: string | null;  // the site's own labels, read the values off a result, never guess one from prose
      listPrice: number | null;
      price: number | null;
      monthlyPrice: number | null;
      financingTermMonths: number | null;
      inStock: boolean | null;
      limitedStock: boolean | null;
      limitedStockNote: string | null;
      insuranceAvailable: boolean | null;
    }
    
    interface VisiblePhoneInsurancePlan {
      id: string;
      name: string;
      monthlyPrice: number | null;
      details: string[];
    }
    
    interface VisiblePhoneFlashSale {
      text: string | null;
      startsAt: string | null;
      endsAt: string | null;
      /** The site's own flag, which is stale `true` on devices whose sale ended
       * months ago. `active` is computed from the dates and is the one to trust. */
      enabledBySite: boolean;
      active: boolean | null;
    }
    
    interface VisiblePhoneImage {
      url: string;
      sku: string | null;
      color: string | null;
      position: string | null;
    }
    
    interface VisibleGetPhoneResult {
      source: string;
      slug: string;
      name: string;
      make: string | null;
      description: string | null;
      deviceOs: string | null;
      listPrice: number | null;
      price: number | null;
      monthlyPrice: number | null;
      variants: VisiblePhoneVariant[];
      choices: Record<string, string[]>;
      fiveG: string | null;
      simSlotType: string | null;
      badge: string | null;
      specs: string[];
      specsUrl: string | null;
      images: VisiblePhoneImage[];
      insurancePlans: VisiblePhoneInsurancePlan[];
      financing: string[];
      tradeInEligible: boolean | null;
      swapEligible: boolean | null;
      visiblePaybackEligible: boolean | null;
      comingSoon: boolean | null;
      preOwned: boolean | null;
      flashSale: VisiblePhoneFlashSale | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/visible/getPhone

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.visible.getPhone("iphone-16e");
  • getPlansReturns Visible's current prepaid plan line-up as structured rows.

    Arguments

    None.

    Returns VisibleGetPlansResult

    interface VisiblePlanFeature {
      label: string | null;
      items: string[];
    }
    
    interface VisiblePlan {
      name: string;
      monthlyPrice: number;
      regularPrice: number | null;
      promoCode: string | null;
      promoText: string | null;
      taxesAndFeesIncluded: boolean | null;
      badge: string | null;
      ctaCode: string | null;
      ctaUrl: string | null;
      features: VisiblePlanFeature[];
    }
    
    interface VisibleGetPlansResult {
      source: string;
      plans: VisiblePlan[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/visible/getPlans

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.visible.getPlans();
  • listDealsReturns the promotions Visible is running right now and what each one is actually worth, read off the site’s own deals page: every offer tile with…

    Arguments

    NameTypeRequired
    options{ includePrograms?: boolean }No

    Returns VisibleListDealsResult

    interface VisibleDealOffer {
      id: string;
      title: string;
      description: string;
      badge: string | null;
      promoCode: string | null;
      promoText: string | null;
      amounts: string[];
      ctaUrl: string | null;
      ctaLabel: string | null;
      terms: string | null;
      imageUrl: string | null;
    }
    
    interface VisibleDealProgram {
      id: string;
      url: string;
      headline: string;
      summary: string | null;
      amounts: string[];
    }
    
    interface VisibleUnreadableProgram {
      id: string;
      url: string;
      reason: string;
    }
    
    interface VisibleListDealsResult {
      source: string;
      offers: VisibleDealOffer[];
      programs: VisibleDealProgram[];
      unreadablePrograms: VisibleUnreadableProgram[];
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.visible.listDeals();
  • searchPhonesReturns the phones Visible currently sells, with the facts a purchase turns on.

    Arguments

    NameTypeRequired
    options{ make?: string; priceMax?: number; supports5G?: boolean; inStock?: boolean; page?: number; pageSize?: number }No

    Returns VisibleSearchPhonesResult

    interface VisiblePhoneFlashSale {
      text: string | null;
      startsAt: string | null;
      endsAt: string | null;
      /** The site's own flag, which is stale `true` on devices whose sale ended
       * months ago. `active` is computed from the dates and is the one to trust. */
      enabledBySite: boolean;
      active: boolean | null;
    }
    
    interface VisibleSearchPhone {
      slug: string;
      name: string;
      make: string;
      deviceOs: string | null;
      listPrice: number | null;
      price: number | null;
      monthlyPrice: number | null;
      financingTermMonths: number | null;
      inStock: boolean;
      preOwned: boolean;
      fiveG: boolean;
      eSIMCompatible: boolean;
      comingSoon: boolean;
      tradeInEligible: boolean;
      visiblePaybackEligible: boolean | null;
      imageUrl: string | null;
      source: string;
      flashSale: VisiblePhoneFlashSale | null;
    }
    
    interface VisibleSearchPhonesResult {
      source: string;
      totalCatalogueCount: number;
      filteredCount: number;
      page: number;
      pageSize: number;
      hasMore: boolean;
      availableMakes: string[];
      results: VisibleSearchPhone[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/visible/searchPhones

    Call it

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

Use it from code