Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| SPACE_ID | Yes | Your Contentful space ID (required) | |
| HTTP_HOST | No | Host for HTTP server (default: localhost) | localhost |
| HTTP_PORT | No | Port for HTTP server (default: 3000) | 3000 |
| ENVIRONMENT_ID | No | Environment ID (defaults to "master") | master |
| ENABLE_HTTP_SERVER | No | Set to "true" to enable HTTP/SSE mode | false |
| CONTENTFUL_DELIVERY_ACCESS_TOKEN | Yes | Your Content Delivery API token (required) |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| graphql_query | IMPORTANT: Before using this tool, you MUST first use graphql_list_content_types and graphql_get_content_type_schema to understand the available content types and their structure. Execute a GraphQL query against the Contentful GraphQL API. This tool allows you to use Contentful's powerful GraphQL interface to retrieve content in a more flexible and efficient way than REST API calls. The space ID and CDA token are automatically retrieved from environment variables. |
| graphql_list_content_types | IMPORTANT: Use this tool FIRST before attempting to write any GraphQL queries. This tool lists all available content types in the Contentful space's GraphQL schema. You should always use this tool to understand what content types are available before formulating GraphQL queries. The space ID and CDA token are automatically retrieved from environment variables. |
| 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. This tool provides all fields, their types, and relationships for a content type. You should ALWAYS use this tool to understand the structure of a content type before creating a query for it. The space ID and CDA token are automatically retrieved from environment variables. |
| graphql_get_example | IMPORTANT: Use this tool AFTER using graphql_get_content_type_schema to see example GraphQL queries for a specific content type. Learning from these examples will help you construct valid queries. The space ID and CDA token are automatically retrieved from environment variables. |
| smart_search | Perform intelligent search across multiple content types using cached metadata. This tool automatically searches all text fields in your content types for the given query term. Much faster and easier than manually chaining multiple GraphQL calls. |
| build_search_query | Generate a GraphQL search query for a specific content type based on cached schema information. Returns the query string and variables needed to search text fields in the content type. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| explore-graphql-schema | Explore the GraphQL schema for this Contentful space and get guidance on querying content |
| build-graphql-query | Build a custom GraphQL query for a specific content need |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |