# Storyblok — how to use (mcp.ai)

Connect your Storyblok account and use 10 tools for developer tools straight from your AI agent. Connect with your own API key. Headless CMS with visual editor for content management and delivery across multiple platforms.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_storyblok?ms=1787296140000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `storyblok_fetch_content_type_items_graphql`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/storyblok`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/storyblok/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/storyblok/fetch/content/type/items/graphql` — Fetch multiple stories/content items using Storyblok's GraphQL API with filtering and pagination. Use starts_with with language code prefix (e.g., 'es/*', 'hi/*') to retrieve translated content in spe
  - body: { page?: integer, per_page?: integer, with_tag?: string, starts_with?: string, content_type: string, excluding_slugs?: string, first_published_at_lt?: string }
- `POST https://api.mcp.ai/api/storyblok/fetch/graphql/content/item` — Tool to fetch a single story in a specific language using Storyblok GraphQL API with field-level translations. For each content type (e.g., Page), Storyblok generates a ContentTypeItem field (e.g., Pa
  - body: { id: string, language?: string, content_type: string, resolve_relations?: string }
- `POST https://api.mcp.ai/api/storyblok/get/app` — Tool to retrieve a Storyblok extension/app by ID using the Management API. Use when you need to fetch details about a specific extension or app installed in Storyblok.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/storyblok/get/datasource/entries` — Tool to retrieve datasource entries from Storyblok via GraphQL API. Use when you need to fetch datasource data. Returns datasource entries with fields like id, name, value, and dimension_value.
  - body: { query: string, version?: string, variables?: object }
- `POST https://api.mcp.ai/api/storyblok/get/graphql/rate/limit` — Tool to retrieve rate limit information from Storyblok GraphQL API. Use when you need to check the maximum cost per request to calculate safe request rates (100 / maxCost = requests per second).
  - body: { query?: string }
- `POST https://api.mcp.ai/api/storyblok/get/page/item` — Tool to retrieve a single page item by ID or slug from Storyblok using GraphQL. Use when you need to fetch specific page content with custom field selection. Supports both draft and published versions
  - body: { id?: string, fields?: string, version?: string }
- `POST https://api.mcp.ai/api/storyblok/list/graphql/content/type/items` — Tool to retrieve multiple content items with pagination, filtering, and relation resolution for any Storyblok content type via GraphQL. Content types are dynamically generated as [ContentType]Items (e
  - body: { query: string, version?: string }
- `POST https://api.mcp.ai/api/storyblok/query/page/items` — Execute GraphQL queries to retrieve multiple page items from Storyblok with filtering options. Use when you need to fetch page content with filters like path prefix, publish date, or slug exclusions.
  - body: { query: string, variables?: object }
- `POST https://api.mcp.ai/api/storyblok/retrieve/links/graphql` — Tool to retrieve links for navigation using Storyblok's GraphQL API. Use when you need to fetch navigation links with their metadata (id, uuid, slug, name, published status).
  - body: { query?: string }
- `POST https://api.mcp.ai/api/storyblok/retrieve/tags` — Tool to retrieve tags from Storyblok via GraphQL API. Use when you need to fetch available tags for content organization and filtering.
  - body: { query?: string }

## Example prompts
- "What can I do in Storyblok?"
- "Show me a summary of my Storyblok account"

## More
- Page: https://mcp.ai/storyblok
- Agent spec (llms.txt): https://mcp.ai/storyblok/llms.txt
- Postman collection: https://mcp.ai/storyblok/postman.json