What is androidbuilder-mcp AGENTS.md?

Project instructions for an MCP server that connects coding agents to visual Android app-building websites. MCP is a standard way for software tools to expose actions to an AI agent.

Use them when developing or maintaining the server, its browser connection, or its tools for inspecting and editing AndroidBuilder, MIT App Inventor, Niotron, or Kodular projects.

They give an agent the project structure, design decisions, configuration settings, and safety details needed to work on the server correctly.

androidbuilder-mcp AGENTS.md — Instructions file by williamcorrea23

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods

npx agentmods add instructions/williamcorrea23/androidbuilder-mcp/agents-md

Clone the repo

git clone --depth 1 https://github.com/williamcorrea23/androidbuilder-mcp

Made for: Codex, OpenCode.

Per session 523 This file is loaded in full into every session.

When invoked 523 The same file — it is already loaded in full.

Security scan A 0 findings. Scan, not verified.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5	$0.00523	$0.00523
Opus 5	$0.00262	$0.00262
Sonnet 5	$0.00105	$0.00105
Haiku 4.5	$0.00052	$0.00052

Measured yesterday against content hash 6800f7b9e5a1, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

androidbuilder-mcp AGENTS.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

Origin

Copies of this mod

1 near-identical copy found in the catalogue:

androidbuilder-mcp CLAUDE.md — 98% identical, 2 lines differ

AGENTS.md · 51 lines

What it actually says

AGENTS.md — AndroidBuilder MCP Server

Project Overview

This is an MCP (Model Context Protocol) server written in TypeScript/Node.js that bridges LLMs to the MIT App Inventor / AndroidBuilder / Niotron / Kodular web IDEs via Chrome's DevTools Protocol (CDP) using Puppeteer Core.

Architecture

src/
├── index.ts          # MCP Server, tool registration, routing
├── tools.ts          # All tool implementations (10 tools)
└── browser-bridge.ts # CDP connection, page cache, timeout handling

Key Design Decisions

Single cached CDP connection — avoids WebSocket leak where each call opened a new connection
3-strategy property update — GWT API → top-frame API → DOM input field
Timeout on evaluateInPage — prevents hanging if IDE page freezes (default 15s)
Graceful SIGTERM/SIGINT disconnect — via bridge.setupProcessHandlers()
Env-var driven config — BROWSER_DEBUG_PORT, EVAL_TIMEOUT_MS, ANDROIDBUILDER_DEBUG

Tools (10 total)

Tool	View Required
`get_project_info`	Any
`get_component_tree`	Designer
`get_component_properties`	Designer (component selected)
`update_component_property`	Designer
`add_blocks`	Blocks
`get_blocks_xml`	Blocks
`clear_blocks`	Blocks
`switch_screen`	Any
`list_screens`	Any
`click_element`	Any (fallback)

Development

npm run build       # compile TypeScript → dist/
npm start           # run compiled server
ANDROIDBUILDER_DEBUG=1 npm start  # verbose logging

Common Errors & Fixes

ECONNREFUSED → Chrome not started with --remote-debugging-port=9222
No active tab found → IDE not open or project not loaded
gwt-Tree not found → Switch to Designer view
Blockly not available → Switch to Blocks view
Timeouts → Increase EVAL_TIMEOUT_MS, reload IDE page

Supported IDEs

androidbuilder.in, ai2.appinventor.mit.edu, code.appinventor.mit.edu, niotron.com, makeroid.io, appybuilder.com

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

yesterday First seen · 51 lines · 523 tokens per session scan A 6800f7b9e5a1

Subscribe to this mod's changes

androidbuilder-mcp AGENTS.md is an instructions file published in the GitHub repository williamcorrea23/androidbuilder-mcp (0 stars, last pushed 26d ago), licensed MIT. It adds 523 tokens to every session, about $0.0026 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Browser automation Data and AI LLM Planning androidbuilder app-inventor blockly chrome-devtools-protocol kodular

androidbuilder-mcp AGENTS.md

Getting it into your agent

What it costs to keep this loaded

Grade A, and why

Nothing flagged

Copies of this mod

What it actually says

AGENTS.md — AndroidBuilder MCP Server

Project Overview

Architecture

Key Design Decisions

Tools (10 total)

Development

Common Errors & Fixes

Supported IDEs

What this file has done since we first saw it

Other instructions, from other repositories

rustwright AGENTS.md

browser-debugger-cli CLAUDE.md

cdpilot CLAUDE.md

cdpilot GEMINI.md

browsertap-mcp AGENTS.md

chatgpt-web-handoff CLAUDE.md