devbar.shBLOCK
Drop-in toolbar for any website — annotate the UI and capture selectors, computed styles, React component trees, and screenshots as an agent-ready prompt.
Overview
From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.
Drop-in toolbar for any website. Annotate the UI and capture selectors, computed styles, React component trees, and screenshots as an agent-ready prompt.
[](https://www.npmjs.com/package/devbar.sh) [](./LICENSE)
It follows the host page's theme, so it does not look pasted onto a light app:
Installation
bun add devbar.sh
Usage
Mount `` once, anywhere in your tree. It renders a fixed toolbar and owns its own overlays.
import { Devbar } from "devbar.sh";
function App() {
return (
<>
);
}The stylesheet ships as a separate file — import it once alongside the component:
import "devbar.sh/styles.css";
The CDN build (devbar.sh/cdn) inlines its own styles, so it needs no separate import.
Server-rendered apps
The toolbar is safe to import from a server-rendered tree — a Next.js root layout, a Remix root, an Astro island. It renders nothing on the server and nothing on the first client render, then appears once mounted, because what it draws depends on the host page's theme, a stored bar position and stored settings; producing markup without them would only fail to hydrate.
In Next.js, mount it in the root layout from a 'use client' module:
"use client";
import { Devbar } from "devbar.sh";
import "devbar.sh/styles.css";
export function DevToolbar() {
if (process.env.NODE_ENV !== "development") return null;
return ;
}That still ships the toolbar's stylesheet to production, where the guard means it is never used. To keep it out, put the two imports in a module of their own and pull that module i
715696cf4a33OBSERVED · 2026-10-11Connect
Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control. Replace the environment placeholders with a token scoped to the least it needs.
claude mcp add devbar-test-ui --env BETTER_AUTH_GITHUB_CLIENT_ID=${BETTER_AUTH_GITHUB_CLIENT_ID} --env BETTER_AUTH_GITHUB_CLIENT_SECRET=${BETTER_AUTH_GITHUB_CLIENT_SECRET} --env BETTER_AUTH_GOOGLE_CLIENT_ID=${BETTER_AUTH_GOOGLE_CLIENT_ID} --env BETTER_AUTH_GOOGLE_CLIENT_SECRET=${BETTER_AUTH_GOOGLE_CLIENT_SECRET} -- npx -y [email protected]{
"mcpServers": {
"devbar-test-ui": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"BETTER_AUTH_GITHUB_CLIENT_ID": "${BETTER_AUTH_GITHUB_CLIENT_ID}",
"BETTER_AUTH_GITHUB_CLIENT_SECRET": "${BETTER_AUTH_GITHUB_CLIENT_SECRET}",
"BETTER_AUTH_GOOGLE_CLIENT_ID": "${BETTER_AUTH_GOOGLE_CLIENT_ID}",
"BETTER_AUTH_GOOGLE_CLIENT_SECRET": "${BETTER_AUTH_GOOGLE_CLIENT_SECRET}"
}
}
}
}Exposed tools (18)
17 read · 1 write · 0 destructive.
| Tool | Risk | Description |
|---|---|---|
boom | read | throws |
claim_report | read | Mark a report as yours before working it. Claiming stops the dispatcher from spawning a |
dispatch_report | read | Hand a report to the configured agent CLI as a background task instead of working it yourself. |
echo | read | Echoes its arguments |
get_annotations | read | |
get_console_errors | read | |
get_element_data | read | |
get_prompt | read | |
get_report | read | |
highlight_element | read | Flash an outline around an element in the user |
inspect_element | read | Read a live element: selector, React component path with source file and line, accessibility |
list_pages | read | Pages currently running the devbar toolbar. These are live browser tabs you can inspect, |
list_reports | read | |
list_tasks | read | Dispatcher tasks and their status, including runs started by other sessions. |
resolve_report | read | Close a report once the work is done, recording what changed. |
screenshot_page | read | Capture the live page, or one element of it. Use this after a change to check the result |
search_reports | read | |
wait_for_reload | write | Block until the page reloads (after an HMR update or a navigation), then report the new page. |
Trust audit
BLOCKgrade D · trust 69/100 Do not install this without reading the findings. The audit found something that could harm you or your machine.
| Layer | What it checks | Result |
|---|---|---|
| L0 | Provenance & inventory | FAIL |
| L1 | Static analysis of the code | WARN |
| L2 | Instruction surface (what it tells the agent) | PASS |
| L3 | Class-specific surface | PASS |
| L4 | Behavioural (sandbox) | SKIPPED |
What the source does
- Filesystem
- declared (5 observation(s))
- Network
- declared (5 observation(s))
- Shell
- declared (1 observation(s))
- Dependencies
- not all pinned
- Secrets in source
- none-found
Findings (22)
payload.ts
console.log(`[auth] Password reset requested for ${user.email}: ${url}`);console.log(`token: ${token}`);return createHash("sha1").update(`blob ${bytes.length}\0`).update(bytes).digest("hex");import type { WorkspaceConfig } from "../../config";import type { WorkspaceConfig } from "../../config";import type { WorkspaceConfig } from "../../config";import type { WorkspaceConfig } from "../../config";export type { WorkspaceConfig } from "../../config";shell is also at `http://127.0.0.1:3100/`. Pages save to disk as you edit
- `host_permissions` for `http://127.0.0.1/*` and `http://localhost/*`. (G15)
project's `origins`, or `http://localhost:*` / `http://127.0.0.1:*`. Everything
requests. The server serves it at `http://127.0.0.1:3100/`; see
`http://localhost:*`, `http://127.0.0.1:*`, and any origin a project claims
return atob(padded.replace(/-/g, "+").replace(/_/g, "/"));
const binary = atob(data.replace(/\s/g, ""));
@base-ui/react, @fontsource-variable/geist, better-auth, class-variance-authority, clsx, lucide-react, react, react-dom
next, react, react-dom, @types/node, @types/react, typescript
html-to-image, jiti, @drizzle-team/brocli, @libsql/client, @modelcontextprotocol/sdk, @playwright/test, @types/bun, @types/react
react, react-dom, @types/bun, @types/react, @types/react-dom
session, a webhook, or a report you attach to a ticket.
webhook route (`POST <mount>/webhook`, HMAC-verified with the webhook secret)
Gates applied: no_behavioural_pass.
715696cf4a33full audit observations/trust-audit/mcp-server/timmikeladze__devbar.json · Report an issue / request a re-scanAudit history
Every audit this server has had. A grade with a past is a grade somebody is still checking.
| Date | Source | Verdict | Grade | Score | Change |
|---|---|---|---|---|---|
| 2026-10-11 | 715696cf4a33 | BLOCK | D | 69 | first audit |
Questions
What is the devbar.sh MCP server?
Drop-in toolbar for any website — annotate the UI and capture selectors, computed styles, React component trees, and screenshots as an agent-ready prompt.
What tools does devbar.sh expose?
18 in total: 17 read-only, 1 that write, and 0 that can delete or overwrite. Every one is listed on this page with its risk.
Is devbar.sh safe to connect to an agent?
No — not without reading the findings first. The audit graded it D (69/100) and found 1 critical or high issue in the source. Each one is listed on this page with the file and line it is on.
What credentials does devbar.sh need?
It reads BETTER_AUTH_GITHUB_CLIENT_ID, BETTER_AUTH_GITHUB_CLIENT_SECRET, BETTER_AUTH_GOOGLE_CLIENT_ID, BETTER_AUTH_GOOGLE_CLIENT_SECRET, BETTER_AUTH_SECRET, BETTER_AUTH_URL, DEVBAR_HMAC_SECRET, DEVBAR_TOKEN, STRIPE_SECRET_KEY, STRIPE_WEBHOOK_SECRET and TURSO_AUTH_TOKEN from the environment. Give it a token scoped to the least it needs — an agent that can be talked into calling a tool can be talked into calling it with your credentials.
How does devbar.sh run?
It speaks streamable-http, so it runs as a service you connect to over the network. It is published on npm as devbar-test-ui at 0.1.0.
How current is this page?
The grade is for one exact copy of the source (715696cf4a33), read on 2026-10-11. The repository is watched and re-audited when it changes.