> ## Documentation Index
> Fetch the complete documentation index at: https://docs.famulor.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Magicline

> Connect your fitness studio to assistants and automations

Open **Agent Tools → Marketplace → Magicline**. Enter your Studio ID and API key. The connection checks studio access before saving. Assign it to an assistant.

Under **Installed → Edit → Tools**, select or deselect operations. Six verified studio/class read tools are enabled initially. The full catalog includes 169 documented operations; selecting an operation does not grant access to it. Other reads require provider permission. Writes are listed for configuration but cannot run through the current read-only proxy.

Open **Automations → Connections** and connect Magicline, or choose **Import from Agent Tools**. The import keeps the selected tools. Add a **Magicline** action and fill its fields using earlier step outputs. Responses are available as the action result.

Use a schedule, manual run, conversation event or inbound webhook to start the flow. This connection does not subscribe to Magicline events. Use action results in subsequent steps with other connected apps.

Course pages contain up to ten items with a continuation cursor. Check for more pages. A course marked bookable may be full or use a waitlist; booking eligibility and a confirmed reservation are separate. Studio opening hours can differ from the public website; resolve conflicting sources before making promises.

## Booking availability

The current connection supports reading studio and course information, but cannot create bookings. Booking requires both write access and support for the requested booking operation.

Confirm a booking only after the action returns a successful reservation. If the result is unclear, check its status before retrying to avoid duplicate bookings.

## API, MCP, CLI & SDK

`POST /api/v1/tools/magicline` · MCP `connect_magicline` · CLI `famulor connect-magicline`.

`POST /api/v1/automations/connections/import` · MCP `import_automation_connection` · CLI `famulor import-automation-connection`.

```bash theme={null}
famulor connect-magicline --studio-id "$STUDIO_ID" --api-key "$MAGICLINE_KEY" --name magicline_studio
famulor import-automation-connection --user-tool-id "$TOOL_ID"
```

```typescript theme={null}
import { Famulor } from 'famulor-sdk';

const client = new Famulor({ apiKey: process.env.FAMULOR_API_KEY });
const { data: tool } = await client.api.connectMagicline({ body: {
  studio_id: process.env.MAGICLINE_STUDIO_ID!,
  api_key: process.env.MAGICLINE_KEY!,
  name: 'magicline_studio',
} });
const { data: connection } = await client.api.importAutomationConnection({
  body: { user_tool_id: tool.id },
});
console.log({ toolId: tool.id, connectionId: connection.id });
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.