dreamworkhq/mcp

API; it does not include the API, database, workers, or hosted OAuth service.
Connect over HTTP at https://mcp.dreamworkhq.com/mcp, or run the stdio client
with npx -y @dreamworkhq/mcp. Public job browsing works without a key.
For source development, use Node 22 and pnpm 10.23.0:
bash
pnpm install --frozen-lockfile
pnpm check
pnpm test
pnpm build
pnpm test:package
The MCP client is in apps/mcp. packages/api-contracts and
packages/assistant-contracts contain its source dependencies; they are bundled
into the published CLI. source-export.json records the release's source commit.
See CONTRIBUTING.md for how changes reach a release.
# @dreamworkhq/mcp
MCP server for Dreamwork: job-search tools for AI agents. Any MCP client (Claude Desktop, Cursor, the MCP Inspector) can use it to find roles, rank them, tailor applications, apply, and track outcomes for one person over time.
This server is a thin gateway: it calls the Dreamwork API over HTTPS and holds no database access of its own. Transport is stdio, and stdout carries only JSON-RPC frames.
## Install
There is no install step. MCP clients run it on demand with npx. The examples below use npx -y @dreamworkhq/mcp.
No key or account is needed to start. Without DREAMWORKAPIKEY the server
runs in free guest mode, where your agent can search and read every listing.
The env blocks below are optional; add a key when you want the account
tools (see Guest mode and API keys).
## Configure
### Claude Desktop
Add an entry to your claudedesktopconfig.json
(~/Library/Application Support/Claude/claudedesktopconfig.json on macOS):
json
"mcpServers": {
"dreamwork": {
"command": "npx",
"args": ["-y", "@dreamworkhq/mcp"],
"env": {
"DREAMWORKAPIKEY": "sk..."
Restart Claude Desktop after editing. Put credentials in the env block. Do not
wrap command in a shell or an env-loader such as dotenvx run -- …: on a stdio
server, any banner the wrapper prints to stdout corrupts the JSON-RPC stream and
hangs tool calls.
### Cursor and other clients
Any stdio MCP client works. Cursor uses the same config shown above: point the
command at npx -y @dreamworkhq/mcp and pass DREAMWORKAPIKEY in the
environment. To check the setup with the Inspector:
bash
DREAMWORKAPIKEY=sk... npx @modelcontextprotocol/inspector npx -y @dreamworkhq/mcp
### Hosted endpoint
Dreamwork also serves these tools over Streamable HTTP at
https://mcp.dreamworkhq.com/mcp. In claude.ai, Claude Desktop, or ChatGPT,
add that URL as a custom connector and sign in to Dreamwork. There is nothing
to install and no key to paste. The consent screen asks which scopes the
connector gets.
Clients that set request headers can send an API key to the same URL
instead. In Claude Code:
bash
claude mcp add --transport http dreamwork https://mcp.dreamworkhq.com/mcp \
--header "Authorization: Bearer sk..."
## Guest mode and API keys
Guest mode is free and needs no account. With no key set, the server starts in
guest mode and exposes the public, read-only tools: browselistings,
getlisting, getplatformcontext, and getupgradelink. The server tells
the agent it is in guest mode, so the agent can say what works now. Account
tools answer with a short "No API key" message that lists the steps to get one.