Skip to main content
This page is for non-technical users. Use it when you want Codex, ChatGPT, Claude, OpenClaw, or another AI agent to help with DealDash screenshots, LinkShot view logs, deals, links, or summaries.

​
Fastest Path

  1. Open DealDash.
  2. Go to Tools > AI Agent Setup.
  3. Click Copy prompt.
  4. Paste the prompt into your AI app.
  5. If the agent is not connected, open the DealDash login approval link it sends back.
  6. Ask for read-only data first.
You do not need to understand MCP to start. MCP is just the connection method the AI app may use in the background.

​
Ready Prompt

Copy this from the DealDash dashboard so the links stay current. The prompt is short on purpose. It gives the agent safe sources, starts with read-only data, and keeps secrets out of chat. 
You are my DealDash agent setup helper.

Start read-only. Use the DealDash Agent Bridge only for DealDash data: screenshots, LinkShot View Logs, due-view checks, short links, deals, contacts, tasks, suggestions, and memory.

Setup sources:
- Simple guide: https://docs.drdj.me/agents/agent-quick-start
- Public setup kit: https://github.com/djasha/dealdash-agent-kit
- Exact tool reference, only if needed: https://docs.drdj.me/internal/dealdash-agent-bridge-plugin

Safety rules:
- Do not ask for my DealDash password or any secret in chat.
- If DealDash is not connected, start DealDash login authorization and send me the approval link.
- Do not ask me for API keys, service secrets, or internal IDs.
- Do not require internal operator secrets, user IDs, or deploy settings for normal user setup.
- First show only data you can read.
- Before creating, updating, deleting, sharing, sending messages, payments, or saving memory, explain the change and wait for my approval.

Connection bootstrap:
- If MCP tool agent_auth_start is available, call it and send me only the returned authorizeUrl.
- If MCP is not connected but you can make HTTPS requests, POST to https://dealdash.neonoir.ai/api/agent/auth/start with JSON {"actorId":"openclaw-agent","channel":"openclaw:setup"}, send me only auth.authorizeUrl, keep auth.deviceCode private inside your session, then poll auth.statusEndpoint.
- If you cannot call MCP tools or make HTTPS requests, say that your AI environment lacks tool access. Do not ask me for internal env vars.

First read-only checks:
1. If not connected, create a DealDash login approval link with MCP or direct HTTPS and wait for me to approve it.
2. Search DealDash context for my account.
3. Show latest screenshots.
4. Show recent LinkShot View Logs.
5. Show posts that still need view checks.

After that, tell me what connected, what data you can read, and the safest next step.

​
Command For Terminal Agents

If your AI agent uses a terminal, it may run this safe command: 
git clone https://github.com/djasha/dealdash-agent-kit.git
cd dealdash-agent-kit
That public repo contains instructions and placeholder examples only. It does not contain passwords, keys, or private DealDash data.

​
Good First Requests

  • “Show my latest screenshots.”
  • “Search DealDash for this promo code, person, link, or screenshot.”
  • “Show my LinkShot View Logs for this week.”
  • “Which posts still need views checked?”
  • “Summarize screenshots shared with me.”
  • “Find the deal for this promo code.”
  • “Shorten this link for me: https://example.com”
  • “Upload this image to LinkShot and give me the short link.”
The first five are read-only checks. They help you confirm the connection before changing anything. Shortening a link or uploading a screenshot creates a new DealDash record. Ask the agent to explain it first if you want to stay read-only. Agent memory is optional. Ask the agent what it wants to save before allowing it. Good memories are short notes like preferred image format, repeated troubleshooting steps, or a decision you want future agents to remember.

​
Image Uploads

DealDash accepts common web images: PNG, JPG/JPEG, WebP, GIF, AVIF, and BMP up to 40MB by default. If an image from WhatsApp, Telegram, Slack, Mattermost, OpenClaw, Hermes, Codex, or Claude fails, ask the agent to convert it to PNG, JPG, or WebP and try again. SVG, HEIC, and TIFF are intentionally not accepted by default because they can be unsafe or unreliable in browser previews.

​
Common Problems

ProblemWhat To Do
The agent asks for your DealDash passwordStop. Passwords do not belong in AI chat. Ask for a DealDash login approval link instead.
The agent asks for API keys, service secrets, or IDsAsk it to use DealDash login-link auth. Normal setup uses agent_auth_start or the public /api/agent/auth/start endpoint.
The agent cannot see screenshots or LinkShot logsCheck the right DealDash account, date filters, LinkShot upload status, and whether shared/team records should be included.
The agent says a write is blockedThat is expected for sensitive actions. Ask the agent to explain the change, then approve only if it matches what you want.
The AI app does not support MCPUse a terminal-based agent, Codex, Claude Code, OpenClaw, or another agent that can run the DealDash Agent Bridge.
  • Simple guide: for people.
  • Agent setup files: for the AI agent when it needs commands or examples.
  • Agent reference: only for exact tool names, API routes, and headers.
Most people only need the dashboard prompt.

​
What Needs Approval

Ask the agent to explain the change before approving any of these:
  • creating or changing deals
  • creating, changing, or deleting payments
  • deleting screenshots or links
  • changing team sharing or visibility

​
For Agents And Developers

These pages are tagged for agents that need exact names, routes, and tool contracts: Start read-only. Let the agent look first. Approve changes only after the agent explains what it will change and why.