Quickstart

Go from no account to a first reading, by an agent over MCP or by curl.

Connect a camera, set up an endpoint and read its value, by an agent over MCP or by curl. At the end you’ll have a live reading, in about 15 minutes.

Know what it takes

You need a computer that can run Docker, beside a camera. Signing up takes no card.

Connecting the camera, seeing its view and your first answer are free. To keep an endpoint reading, a person pays first: $99 a month for your first question, $49 for each one after that. Full refund for 30 days. See Billing.

Connect a camera

Everyone does this part first.

Create an account

Sign up at dialectlayer.com/sign-up. You get a workspace.

Add a gateway

A gateway is the small program that watches your camera. In the console, open Gateways, then Add a gateway, then Your computer, and run its command on a computer beside the camera. You need Docker.

Start the gateway

You should see the container’s ID.

Choose your camera

Open http://localhost:8765 on that computer. Choose your camera and give its login, then select Use this camera. Select Add to workspace, choose your workspace and select Add. The gateway starts within about 15 seconds.

Know the camera’s address already, or want an agent to do this? Open Other ways to connect in the console.

Check the view

On the gateway’s page in the console, open Check the view. You should see what the camera sees. This is free.

Ask your one free question

Your first answer is free: a person asks what to watch in the console, or an agent they signed in calls dialect_setup. Dialect proposes an endpoint, and it starts reading once they pay with the button on the proposal. See Billing.

If anything goes wrong, Connect a camera lists every problem and its fix.

Run your first read from an agent

Connect the agent

In Claude Code, run this, then run /mcp, choose dialect and sign in. No token is needed. For other apps, see Connect an agent.

Add Dialect to Claude Code

You should see dialect read Connected.

Ask for what you want to know

Ask your agent to set it up
With Dialect, tell me whether the loading bay is free, and keep checking it as an endpoint.

The agent calls dialect_setup. Dialect takes a photo, finds the bay, drafts fields and tests them. This takes about 1 to 3 minutes.

Confirm it

Open dialectlayer.com/endpoints. The proposal is under Waiting for you, with the photo and what each field reads now. Select Start reading. An agent can’t do this step for you. You should see it leave Waiting for you and join your endpoints.

Ask again

Ask your agent for the value
Is the loading bay free?

The agent calls dialect_read_endpoint. You should see a short answer:

Response from dialect_read_endpoint

Run your first read with curl

Create a token

In the console, open Access, then Grant access, then An agent’s token. Choose which gateways it may use and select Issue token. It’s shown once.

Keep your token in the shell

See your gateways

List your gateways

A 401 means the token is missing, mistyped or revoked: issue a new one on Access. Otherwise you should see a list with one entry per gateway. One with "gateway_id": "loading-dock", "online": true and "can_serve_endpoints": true is ready.

Start a setup

Say what you want to know, in your own words.

Start a setup

You should see a 201 with "state": "running" and an id. Keep the id as RUN_ID.

Wait for its proposal

Each call holds for up to 20 seconds. Call again while state is running, until you see "ending": "proposed".

Check the setup
Response once it has proposed

Confirm it

Open dialectlayer.com/endpoints and select Start reading under Waiting for you. Until then, reading it answers 404 with code: "not_confirmed".

Read it

The first reading usually comes within about 30 seconds.

Read the endpoint

You should see values.bay_free with its value, quality and since.

Trust a value when its quality is valid and fresh is true. Read an endpoint explains the rest of the answer.

Next steps