Solidcore MCP server for AI agents

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

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

Connect

Just Solidcore

An MCP server for Solidcore 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/solidcore
Every site

One MCP server for Solidcore 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 12
  • checkAvailabilityChecks real-time availability for a class (bookable, waitlist, or full).

    Arguments

    NameTypeRequired
    argsCheckAvailabilityArgsYes
    interface GetClassArgs {
      id: number;             // a class id, e.g. from a getSchedule row
      locationId: string;     // the studio the class belongs to, also off a getSchedule row
      startDate?: string;     // "YYYY-MM-DD", defaults to today, widen if the class falls outside it
      endDate?: string;       // "YYYY-MM-DD", defaults to startDate + 7 days
    }
    
    type CheckAvailabilityArgs = GetClassArgs;   // same { id, locationId } off a getSchedule row

    Returns SolidcoreClassAvailability

    interface SolidcoreClassAvailability {
      id: number; locationId: string; className: string; startTime: string;
      capacity: number; openings: number; waitlistSize: number;
      availability: "bookable" | "waitlist" | "full_no_waitlist";
      isCanceled: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/solidcore/checkAvailability

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.solidcore.checkAvailability("<args>");
  • getClassReturns one class's full details: name, time, duration, coach, studio, capacity, description.

    Arguments

    NameTypeRequired
    idnumber
    A class id, e.g. from a getSchedule row.
    Yes
    locationIdstring
    The studio the class belongs to.
    Yes
    startDatestring
    "YYYY-MM-DD", defaults to today.
    No
    endDatestring
    "YYYY-MM-DD", defaults to startDate + 7 days.
    No

    Returns SolidcoreClass

    interface SolidcoreClass {
      id: number;
      className: string;
      displayClassName: string;
      startTime: string;        // the studio's own local time, as the site prints it
      endTime: string;
      timezone: string;
      coach: string;
      coachId: number;
      locationId: string;
      capacity: number;
      openings: number;
      waitlistSize: number;
      availability: "bookable" | "waitlist" | "full_no_waitlist";
      description: string;
      category: string;
      isCanceled: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/solidcore/getClass

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.solidcore.getClass({ id: 1, locationId: "<locationId>" });
  • getCoachReturns one coach's own trainer page: name, role, the page's own bio blurb, and photo URL.

    Arguments

    NameTypeRequired
    slugstring
    The coach's /trainer/<slug> identifier.
    Yes

    Returns SolidcoreCoachProfile

    interface SolidcoreCoachProfile {
      slug: string;
      name: string;
      role: string;   // e.g. "Senior Master Coach", empty when the page's title shows none
      bio: string;     // the page's own bio blurb; empty when the page carries none
      photoUrl: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/solidcore/getCoach

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.solidcore.getCoach({ slug: "<slug>" });
  • getPackReturns one class pack, drop-in or intro pass in full: price, class count, how long it stays valid, whether it sells online and where it can be used.

    Arguments

    NameTypeRequired
    locationIdstring
    E.g. "11" for Castro, what listStudios returns.
    Yes
    idstring
    A pass id off getPricing, e.g. "10106".
    Yes

    Returns SolidcorePack

    interface SolidcorePass {
      id: string;
      name: string;
      type: "Unlimited" | "Series" | "DropIn";
      price: number;             // full price, in dollars
      pricePerClass: number;     // the site's own "$X/class" framing
      classCount: number;        // a very large sentinel for an unlimited pass
      newClientOnly: boolean;
      description: string;
      finePrint: string;
    }
    
    interface SolidcorePack extends SolidcorePass {
      expirationLength: number | null;     // how long the pack stays valid
      expirationUnit: string | null;       // e.g. "Days"
      expirationStartsFrom: string | null; // "SaleDate" = from purchase
      sellOnline: boolean;
      onlinePrice: number;
      useAtLocationIds: number[];          // studios its classes can be booked at
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/solidcore/getPack

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.solidcore.getPack({ locationId: "11", id: "10106" });
  • getPricingReturns one studio's pricing: one-time passes (drop-ins and class packs) and recurring memberships (autopay).

    Arguments

    NameTypeRequired
    locationIdstring
    E.g. "11" for Castro, what listStudios returns.
    Yes

    Returns SolidcorePricing

    interface SolidcorePass {
      id: string;
      name: string;
      type: "Unlimited" | "Series" | "DropIn";
      price: number;             // full price, in dollars
      pricePerClass: number;     // the site's own "$X/class" framing
      classCount: number;        // a very large sentinel for an unlimited pass
      newClientOnly: boolean;
      description: string;
      finePrint: string;
    }
    
    interface SolidcoreMembership {
      id: number;
      name: string;
      monthlyPrice: number;        // charged monthly once autopay starts
      firstPaymentPrice: number;   // sometimes different from the recurring amount
      totalContractPrice: number;  // total across the whole commitment
      numberOfPayments: number;
    }
    
    interface SolidcorePricing {
      passes: SolidcorePass[];
      memberships: SolidcoreMembership[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/solidcore/getPricing

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.solidcore.getPricing({ locationId: "11" });
  • getScheduleReturns the class schedule for one studio over a date window: class name, coach, start/end time, capacity, openings, waitlist size, and a live…

    Arguments

    NameTypeRequired
    locationIdstring
    E.g. "11" for Castro, what listStudios returns.
    Yes
    startDatestring
    "YYYY-MM-DD", defaults to today.
    No
    endDatestring
    "YYYY-MM-DD", defaults to startDate + 7 days.
    No

    Returns SolidcoreClass[]

    interface SolidcoreClass {
      id: number;
      className: string;
      displayClassName: string;
      startTime: string;        // the studio's own local time, as the site prints it
      endTime: string;
      timezone: string;
      coach: string;
      coachId: number;
      locationId: string;
      capacity: number;
      openings: number;
      waitlistSize: number;
      availability: "bookable" | "waitlist" | "full_no_waitlist";
      description: string;
      category: string;
      isCanceled: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/solidcore/getSchedule

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.solidcore.getSchedule({ locationId: "11" });
  • getStudioReturns one studio's own record off the same registry listStudios reads: name, full address, state, siteId/locationId pair, phone, email, and whether…

    Arguments

    NameTypeRequired
    locationIdstring
    E.g. "11", only unique paired with siteId; both come off the same listStudios row.
    No
    siteIdstring
    Required alongside locationId.
    No
    slugstring
    The site's own studioIdentifier, e.g. "castro".
    No

    Returns SolidcoreStudio

    interface SolidcoreStudio {
      siteId: string;       // a REGIONAL group (38 of them); locationId is unique only within one
      locationId: string;   // disambiguates THIS studio under siteId, repeats across siteId groups
      slug: string;          // the site's own studioIdentifier, e.g. "castro", globally unique
      name: string;
      address: string;       // full street address, as the site publishes it (no separate city field exists)
      state: string;         // two-letter code, e.g. "CA"
      stateName: string;     // e.g. "California"
      phone: string;
      email: string;
      comingSoon: boolean;   // true when the site's own infoFlag marks it not yet open
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/solidcore/getStudio

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.solidcore.getStudio({ siteId: "5723396", locationId: "11" });
  • listClassCategoriesLists the class formats [solidcore] offers chain-wide (e.g. "Signature50", "Power30", "Starter50"), each with its own description.

    Arguments

    None.

    Returns SolidcoreClassCategory[]

    interface SolidcoreClassCategory {
      classType: string;       // the site's own short format name, e.g. "Signature50"
      classTypeId: number;
      category: string;        // the site's one chain-wide top-level category, always "Strength training"
      categoryId: number;
      descriptions: string[];  // usually one description; Power30 carries two distinct ones
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/solidcore/listClassCategories

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.solidcore.listClassCategories();
  • listCoachesLists the coaches shown on one studio's own page: name, trainer slug, role, and photo URL.

    Arguments

    NameTypeRequired
    locationIdstring
    E.g. "11", only unique paired with siteId; both come off the same listStudios row.
    No
    siteIdstring
    Required alongside locationId.
    No
    slugstring
    The site's own studioIdentifier, e.g. "castro".
    No

    Returns SolidcoreCoach[]

    interface SolidcoreCoach {
      slug: string;         // the site's own /trainer/<slug> identifier
      name: string;
      role: string;          // e.g. "Senior Master Coach", empty when the page shows none
      photoUrl: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/solidcore/listCoaches

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.solidcore.listCoaches({ slug: "castro" });
  • listMuscleGroupsReturns the chain-wide daily muscle-focus calendar.

    Arguments

    NameTypeRequired
    startDatestring
    "YYYY-MM-DD", defaults to today.
    No
    endDatestring
    "YYYY-MM-DD", defaults to startDate + 7 days.
    No

    Returns SolidcoreMuscleFocusDay[]

    interface SolidcoreMuscleFocusDay {
      date: string;           // "YYYY-MM-DD"
      muscleFocus: string;    // the chain-wide primary focus for the day, e.g. "Hamstrings"
      muscleFocus2: string;   // the chain-wide secondary focus, e.g. "Biceps"
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/solidcore/listMuscleGroups

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.solidcore.listMuscleGroups();
  • listStudiosLists all Solidcore studios with locations, slug, and siteId+locationId pairs; optionally filtered to one state.

    Arguments

    NameTypeRequired
    statestring
    Two-letter state code, e.g. "CA".
    No

    Returns SolidcoreStudio[]

    interface SolidcoreStudio {
      siteId: string;       // a REGIONAL group (38 of them); locationId is unique only within one
      locationId: string;   // disambiguates THIS studio under siteId, repeats across siteId groups
      slug: string;          // the site's own studioIdentifier, e.g. "castro", globally unique
      name: string;
      address: string;       // full street address, as the site publishes it (no separate city field exists)
      state: string;         // two-letter code, e.g. "CA"
      stateName: string;     // e.g. "California"
      phone: string;
      email: string;
      comingSoon: boolean;   // true when the site's own infoFlag marks it not yet open
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/solidcore/listStudios

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.solidcore.listStudios();
  • searchClassesSearches classes by muscle group, coach, time, or date.

    Arguments

    NameTypeRequired
    locationIdstring
    E.g. "11" for Castro, what listStudios returns.
    Yes
    coachstring
    Case-insensitive substring match against the class row's own coach name.
    No
    categorystring
    Case-insensitive substring match against the class row's own category, e.g. "Strength training".
    No
    muscleGroupstring
    Case-insensitive substring match against the DAY's chain-wide muscle focus (listMuscleGroups).
    No
    availability"bookable" | "waitlist" | "full_no_waitlist"No
    startDatestring
    "YYYY-MM-DD", defaults to today.
    No
    endDatestring
    "YYYY-MM-DD", defaults to startDate + 7 days.
    No

    Returns SolidcoreClass[]

    interface SolidcoreClass {
      id: number;
      className: string;
      displayClassName: string;
      startTime: string;        // the studio's own local time, as the site prints it
      endTime: string;
      timezone: string;
      coach: string;
      coachId: number;
      locationId: string;
      capacity: number;
      openings: number;
      waitlistSize: number;
      availability: "bookable" | "waitlist" | "full_no_waitlist";
      description: string;
      category: string;
      isCanceled: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/solidcore/searchClasses

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.solidcore.searchClasses({ locationId: "11", category: "Strength" });
Act 2
  • bookClassBooks the signed-in member into a class off getSchedule, spending a pass or membership they already hold.

    Arguments

    NameTypeRequired
    idnumber
    Class id off a getSchedule row.
    Yes
    datestring
    "YYYY-MM-DD", the class's own date (a row's startTime works too).
    Yes
    siteIdstring
    Off listStudios, e.g. "5723396".
    Yes
    locationIdstring
    Off listStudios, e.g. "11".
    Yes
    packageIdnumber
    Which held pass to spend; omit to let the site choose.
    No
    membershipIdnumberNo

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/solidcore/bookClass

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.solidcore.bookClass({
      id: 1,
      date: "<date>",
      siteId: "<siteId>",
      locationId: "<locationId>"
    });
  • joinWaitlistJoins the signed-in member to a full class's waitlist.

    Arguments

    NameTypeRequired
    idnumber
    Class id off a getSchedule row.
    Yes
    datestring
    "YYYY-MM-DD", the class's own date (a row's startTime works too).
    Yes
    siteIdstring
    Off listStudios, e.g. "5723396".
    Yes
    locationIdstring
    Off listStudios, e.g. "11".
    Yes
    packageIdnumber
    Which held pass to spend; omit to let the site choose.
    No
    membershipIdnumberNo

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/solidcore/joinWaitlist

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.solidcore.joinWaitlist({
      id: 1,
      date: "<date>",
      siteId: "<siteId>",
      locationId: "<locationId>"
    });

Use it from code