# Contentful GraphQL Server

Enable efficient and flexible content retrieval from Contentful using GraphQL queries. Explore your content model schema, generate example queries, and execute custom queries with smart pagination an…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add ivo-toby/contentful-mcp-graphql

# Browse available tools
npx -y @smithery/cli@latest tool list ivo-toby/contentful-mcp-graphql

# Get full schema for a tool
npx -y @smithery/cli@latest tool get ivo-toby/contentful-mcp-graphql graphql_query

# Call a tool
npx -y @smithery/cli@latest tool call ivo-toby/contentful-mcp-graphql graphql_query '{}'
```

## Tools (6)

- `graphql_query` — IMPORTANT: Before using this tool, you MUST first use graphql_list_content_types and graphql_get_content_type_schema to…
- `graphql_list_content_types` — IMPORTANT: Use this tool FIRST before attempting to write any GraphQL queries. This tool lists all available content ty…
- `graphql_get_content_type_schema` — IMPORTANT: Use this tool AFTER using graphql_list_content_types to get a detailed schema for a specific content type. T…
- `graphql_get_example` — IMPORTANT: Use this tool AFTER using graphql_get_content_type_schema to see example GraphQL queries for a specific cont…
- `smart_search` — Perform intelligent search across multiple content types using cached metadata. This tool automatically searches all te…
- `build_search_query` — Generate a GraphQL search query for a specific content type based on cached schema information. Returns the query strin…

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get ivo-toby/contentful-mcp-graphql <tool-name>
```

## Prompts (2)

- `explore-graphql-schema` (goal) — Explore the GraphQL schema for this Contentful space and get guidance on querying content
- `build-graphql-query` (contentType, fields, filters, includeReferences) — Build a custom GraphQL query for a specific content need

---

Source: https://github.com/ivo-toby/contentful-mcp-graphql | License: MIT