Skip to main content

At a glance

Credentials

Set these per environment. See Connect an integration.

Setup

  1. Create a Weaviate Cloud account: Sign up at https://console.weaviate.cloud. Free 14-day sandbox clusters are available for testing. Self-hosted Weaviate with API-key auth enabled works too.
  2. Create a cluster and grab credentials: Create a cluster, then open Cluster details to copy the REST endpoint URL and an API key (use a read-write key for object creation). The key is only displayed once.
  3. Store the key and note your host: Add WEAVIATE_API_KEY=… to your .env file. Tools take the cluster host (without https://) as the WEAVIATE_CLUSTER_HOST environment variable, e.g. my-cluster-abc123.weaviate.cloud.
  4. Verify access: With WEAVIATE_CLUSTER_HOST configured, run the Get Schema tool.

Provider notes

  • Every tool needs the WEAVIATE_CLUSTER_HOST environment variable; there is no global Weaviate API host
  • nearText GraphQL queries require a vectorizer module configured on the collection (and possibly a model-provider API key set on the cluster)
  • Admin keys can read and write; read-only keys will get 403 on Create Object
Provider API reference.

Tools

Verify the connection

Call a read tool such as weaviate__get_schema with arguments for your account. Confirm that the result comes from the intended account or workspace before enabling write tools.