canonical: https://jentic.com/apis/mydreamthreads.xyz/mydreamthreads

# Mydreamthreads Xyz DreamThreads Dream Interpretation API

The DreamThreads Dream Interpretation API generates context-aware interpretations of written dreams and parses free-text dreams into structured context. A free public parse operation is available without an API key, and a health check reports service availability. Its outputs are reflective rather than diagnostic or predictive.

## For AI agents

Generate context-aware dream interpretations and parse free-text dreams into structured context, with a free public parse operation and a health check for availability.

## Scope

Does not handle dream journaling, user accounts, or medical diagnosis. Use for dream interpretation and structured parsing only.

## Capabilities

- Generate a context-aware interpretation of a written dream
- Parse a free-text dream into structured context
- Parse a dream for free without an API key using the public operation
- Check DreamGraph service availability

## Use cases

### Dream Interpretation Inside an AI Agent

An AI agent takes a dream a user describes and returns a context-aware, reflective interpretation through Jentic. The interpret operation accepts the dream text and produces an interpretation the agent can present in conversation, so a journaling or wellbeing assistant can add dream reflection without building its own language model.

Example prompt: Send a user's written dream to the interpret operation with the stored bearer key and present the returned reflective interpretation.

### Free Structured Dream Parsing

A product previews dream parsing before asking a user to sign up. The public parse operation turns free-text dream input into structured context for free without an API key, so an agent can demonstrate the feature and only move to the authenticated operations when richer interpretation is needed.

Example prompt: Call the public parse operation with a short dream description and show the structured context it returns, without supplying a key.

### Structured Context Pipeline

A pipeline converts raw dream text into structured context that feeds downstream reasoning or storage. The authenticated parse operation returns a structured breakdown of the dream, giving the agent consistent fields to work with before requesting a full interpretation.

Example prompt: Parse a dream with the authenticated parse operation, then pass the structured context to the interpret operation for a fuller reading.

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| POST | `/interpret` | Generate a context-aware dream interpretation |
| POST | `/parse` | Parse a dream into structured context |
| POST | `/public/parse` | Parse a dream for free without an API key |
| GET | `/health` | Check DreamGraph API availability |

## Key resources

- **Interpretation** — Generate a context-aware interpretation from a written dream
- **Parsing** — Turn free-text dreams into structured context, with a free public operation and an authenticated one
- **Health** — Report DreamGraph service availability

## Why Jentic

- **Setup:** Wiring the DreamThreads Dream Interpretation API by hand means handling its bearer partner key, choosing between the free public parse and the authenticated interpret and parse operations, and sending each dream as text yourself. Through Jentic you install once, import it from the API Directory, store the key once, and your agent calls it.
- **Permission scoping:** The operations are what a rule bounds, so you can pin your agent to the ones you want, such as the public parse and the interpret operation. You choose the operations it may call, so the rest are not included unless you add them.
- **Credential handling:** Your DreamThreads partner key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'interpret a dream' or 'parse a dream into structured context', and Jentic returns the matching DreamThreads operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **OpenAI** — General-purpose language models that can also interpret or summarize dream text.
- **Cohere** — Text generation and understanding models for custom interpretation prompts.
- **AssemblyAI** — Speech-to-text that can transcribe a spoken dream before interpretation.

## FAQ

### What authentication does the DreamThreads Dream Interpretation API use?

The interpretation and authenticated parse operations require a bearer token, which DreamThreads issues as a partner API key, per its OpenAPI spec. A separate public parse operation and the health check need no token. Through Jentic the key is stored encrypted in your own Jentic One instance and injected at call time.

### Can I parse a dream without an API key with the DreamThreads Dream Interpretation API?

Yes. The public parse operation returns structured context for a dream for free without a key, while the fuller interpretation and the authenticated parse operation require a bearer token. This lets you try structured parsing before adding credentials.

### What are the rate limits for the DreamThreads Dream Interpretation API?

The OpenAPI spec does not specify rate limits. Check the DreamThreads documentation at https://mydreamthreads.xyz for current limits, especially for the free public parse operation.

### How do I interpret a dream with the DreamThreads Dream Interpretation API through Jentic?

Search Jentic for 'interpret a dream', add the DreamThreads Dream Interpretation API from the directory, and your agent calls the interpret operation with the dream text using your stored bearer key. To run it on your own infrastructure, install Jentic One from its GitHub repo.

### Is there a DreamThreads Dream Interpretation API MCP server?

You don't need an MCP server to give your agent the DreamThreads Dream Interpretation API. Jentic connects it directly from the API Directory: import it, store your partner key once, and your agent calls the interpret and parse operations. Nothing extra loads into the agent's context until a call is made.

### Can I limit what my agent is allowed to do with the DreamThreads Dream Interpretation API?

Yes. Write a rule that allows just the operations you want, such as the free public parse and the interpret operation, so the agent cannot call anything else, and every call is logged. DreamThreads takes the dream text in the request body, so rules bound which operations your agent may call.