Mobbin (mcp-mobbin)
Search Mobbin's library of real app UI screenshots. The official repo calls it "the world's largest library of real app UI screenshots". An agent can query it through the Mobbin MCP via Code Mode. Its documented tool is search_screens, which answers app, screen, flow and element research as query intents.
This packet is a read-only TRANSPORT (packetKind: transport, mutatesWorkspace: false). Every call goes to the external hosted Mobbin service, never this repo. It produces no design tokens or Style Reference of its own. If you also want a measured Style Reference of real, extracted design tokens, pair it with sk-design-md-generator.
Deep operational detail lives in references/tool-surface.md and references/mcp-wiring.md.
Discovery status (read first). The mobbin Code Mode manual IS REGISTERED in this repo's .utcp_config.json. An operator registered it on 2026-07-16. This packet never edits the config.
Live discovery RAN 2026-07-16, pre-auth (fixture: references/discovery-fixture-2026-07-16.json).
list_tools returned THREE read tools. Registry names are mobbin.mobbin.{search_screens,search_flows,search_sections} (dot-separated).
The fixture's Access as: lines show TypeScript callables such as mobbin.mobbin_search_screens(...). This supersedes the research's one-public-tool baseline.
Operator browser OAuth is still pending for CALLS. Per-session tool_info re-confirmation is MANDATORY before relying on any name. Confirm, then call. Fail closed on drift.
Access trap. Mobbin MCP access is documented for Pro, Team, and Enterprise — not Free. Authentication is browser OAuth only (DCR + PKCE S256, openid scope): no static API key or auth env var exists for MCP — that question is answered in the negative, not open. Unauthenticated calls return HTTP 401. The service is rate-limited to 60 requests per 60 seconds per user.
1. WHEN TO USE
Activation Triggers
Use when the user wants to:
- Search Mobbin for real-app design references: screens for a UI pattern or state, apps for category comparison, flows for journey steps, or elements for component behavior in context.
- Find screen examples from shipped apps ("show me iOS banking onboarding screens", "web empty-state dashboard examples").
- Research how real products handle a flow or journey through screen evidence ("first-run onboarding progression", "forgot-password recovery").
- Wire, verify, or troubleshoot the registered
mobbin Code Mode manual, its OAuth authentication, its plan gating, or its rate limit.
Keyword Triggers: "mobbin", "mobbin mcp", "app design research", "screen examples", "ux flow references", "real app screenshots", "search mobbin".
Use Cases
App research (read-only). Name the app, company, or category plus the comparison goal ("banking apps onboarding identity verification"); compare app_name, platform, structure, and visible patterns across results. Multiple results are evidence, not a design chooser.
Screen research (read-only). Name the concrete screen, state, or job ("iOS subscription cancellation confirmation"); start at 5 results; cite each mobbin_url used.
Flow research (read-only). Describe the journey and target step. The public contract returns screens, not an ordered flow object — reconstruct sequence only when visual evidence supports it, and label the reconstruction as inference.
Element research (read-only). Name component plus context/state ("bottom-sheet destructive confirmation", "inline validation on signup"); analyze element behavior within returned screens.
Wiring and auth verification. Report the manual's registration state honestly (presence is the healthy result; absence is a failure symptom to escalate), explain the OAuth-only model and plan gate, and never repair auth state yourself.
When NOT to Use
Skip this skill when:
- The work is measured design-reference extraction: turning a live website's real CSS into a Style Reference DESIGN.md of named design tokens (type scale, components, Quick-Start CSS/Tailwind). That is
sk-design-md-generator; this packet only retrieves Mobbin screenshot evidence.
- The task is styles, screens, or flows research through Refero. That is
mcp-refero, the sibling transport.
- The task is Figma work (inspect, tokens, render, Code Connect). That is
mcp-figma.
- The task is browser automation, live-page inspection, or visual preview of a built page. That is
mcp-chrome-devtools.
- The work is generic app coding with no design-reference input: use
sk-code.
- The target is Mobbin's documentation search.
docs.mobbin.com/mcp is a separate Mintlify docs-search MCP, not the design-reference server; this packet targets api.mobbin.com/mcp only.
- The user asks to change this repo's files, edit the registered
.utcp_config.json manual, or repair auth state. This transport forbids Write/Edit/Task, never mutates the workspace, and the registered manual is operator-owned.
2. SMART ROUTING
The mcp-tooling hub routes a Mobbin request here when the prompt names Mobbin or asks for app design research, real app screenshots or UX flow references, and the hub's mcp-mobbin signal selects this packet.
Generic design, UI or screen phrasing is not a Mobbin signal: measured extraction belongs to sk-design-md-generator, Refero references to mcp-refero, Figma work to mcp-figma, and browser work to mcp-chrome-devtools.
references/tool-surface.md is the research baseline and loads for every research intent, references/mcp-wiring.md and assets/utcp-mobbin-manual.md load for wiring or auth intent, and references/troubleshooting.md for setup and error intent.
A request that scores no intent returns UNKNOWN_FALLBACK with its disambiguation checklist, never a silent default.
Read ROUTER.md before selecting skill-local resources; open only the matched files.
3. HOW IT WORKS
First Step (Always): report the wiring state honestly
The mobbin manual is registered in this repo's .utcp_config.json. An operator registered it on 2026-07-16, not this packet.
scripts/doctor.sh reports the state without changing it. Manual presence is healthy. Absence is now an ERROR. Escalate a missing registration as broken or reverted; never repair it here.
Manuals load at Code Mode startup, and OAuth is still pending. Discovery through a fresh Code Mode session is mandatory before any call:
// Live-confirmed dotted discovery names (2026-07-16 fixture):
// mobbin.mobbin.search_screens · mobbin.mobbin.search_flows · mobbin.mobbin.search_sections
const all = await list_tools();
// MANDATORY per session: confirm the exact callable + schema before relying on any name
const info = await tool_info({ tool_name: "mobbin.mobbin_search_screens" });
Live discovery on 2026-07-16 CONFIRMED both the dotted discovery names and the callable form (references/discovery-fixture-2026-07-16.json). The convention-derived prediction held exactly.
Discovery ran pre-auth: tools/list and schemas needed no OAuth. Authenticated CALLS remain operator-gated.
If future discovery shows different names, missing tools, unexpected new tools or a mutation-capable tool, fail closed. Report the drift. A changed provider surface requires a reviewed packet update, not an improvised call.
The live three-tool surface (supersedes the one-tool baseline, 2026-07-16)
The research's one publicly documented tool baseline is superseded: live pre-auth discovery on 2026-07-16 listed three read-only search tools. All three passed the mutation-refusal check (no mutation-capable tool in the listing). Full fixture schemas and the completeness boundary: references/tool-surface.md.
| Tool |
Posture |
Required inputs (fixture schema) |
Optional inputs (fixture schema) |
search_screens |
Read/search |
query; platform "ios"|"web" |
mode "deep"|"standard"|"fast" (deprecated alias); limit; exclude_screen_ids[]; image_format "webp"|"jpg" |
search_flows |
Read/search |
query (one journey); platform "ios"|"web" |
limit; page (max 20); image_format |
search_sections |
Read/search |
query (one website section) |
limit; page; image_format |
Declared search_screens output (fixture): { query, screens: [{ id, image_url, mobbin_url, app_name, platform }] }.
The research-documented index/failed[] fields do not appear in the declared schema. Verify the actual response shape on the first authenticated call.
The deep conflict is RESOLVED. Search mode is a client-settable input on search_screens: "deep" means an AI-powered relevance pipeline for nuanced queries, "standard" means low latency and "fast" is a deprecated alias for standard.
Never invent search_apps, search_elements or any detail, image-download or mutation tool beyond the discovered inventory.
Calling through Code Mode
Callable-name status. Live discovery on 2026-07-16 confirmed the callable form (references/discovery-fixture-2026-07-16.json). The registry name is mobbin.mobbin.search_screens, and the TypeScript callable is mobbin.mobbin_search_screens(args).
The call below uses the confirmed form. Live RESPONSE behavior remains unexercised because authenticated calls await operator OAuth. Re-confirm the name with tool_info in each session.
Mandatory discovery-first sequence: list_tools() or search_tools({ task_description: "Mobbin screen design research", limit: 10 }) -> filter to the mobbin manual -> tool_info() on the exact dotted name -> only then call_tool_chain({ code }). Cite every selected reference by its mobbin_url.
call_tool_chain({
code: `
const result = await mobbin.mobbin_search_screens({
query: "iOS banking app onboarding identity verification",
platform: "ios",
limit: 5
});
return { success: true, data: result, errors: [], timestamp: new Date().toISOString() };
`
});
Research workflows (query intents over the three live tools)
App, screen, and element research remain intent-specific query designs over search_screens; flow and website-section research now have dedicated live-discovered tools (2026-07-16):
- App research — name the app/company/category and comparison goal ("banking apps onboarding identity verification"); compare
app_name, platform, structure, visible patterns.
- Screen research — name the concrete screen/state/job ("iOS subscription cancellation confirmation", "web empty-state dashboard"); start at 5 results; cite each
mobbin_url used.
- Flow research — use
search_flows: describe one user journey ("onboarding with personalization steps"); it returns ordered flow objects (screens[].position, actions[], screen_count), superseding the old screens-only reconstruction guidance. Label anything beyond the returned ordering as inference.
- Element research — name component + context/state ("bottom-sheet destructive confirmation", "inline validation on signup"); analyze element behavior within returned screens; never fabricate an element-detail tool.
- Website-section research — use
search_sections: describe one section ("pricing page with plan comparison table"); results carry site_name and section images.
Official skill operating sequence:
- Derive query terms from the user's actual words.
- Infer
ios or web from app context. If unclear, ask.
- Announce a short search plan.
- Call
search_screens in the same turn.
- Visually inspect returned references for content, structure, styling and interaction. Compare repeats and meaningful differences, then synthesize principles.
- Answer from evidence tied to returned screens.
The official skill's optional evidence-board writer is excluded from this transport because the transport has a read-only boundary.
Context discipline: start limit: 5; ask before widening materially (do not exceed ~15 just for variety); report failed[] entries and missing images as partial success, never silently discard; retain mobbin_url as provenance for every selected reference.
Auth, plans, and limits
- Auth: Browser OAuth is the only auth method: protected-resource discovery, Dynamic Client Registration (RFC 7591), authorization-code + PKCE S256 and
openid scope.
- No static Mobbin API key exists for MCP. The API-key Bearer model belongs to the separate Team/Enterprise REST API. Never conflate the two.
- Client access is revocable from Mobbin Account Settings -> MCP.
- Adapter auth state persists under
~/.mcp-auth (or MCP_REMOTE_CONFIG_DIR) and is operator-owned. Never inspect, clear or repair it.
- A live unauthenticated probe returned HTTP 401 with a
WWW-Authenticate pointer to the protected-resource metadata. A pre-authorization 401 is the expected challenge, not a missing-key error.
- End-to-end OAuth through the local Code Mode +
mcp-remote bridge is Inferred, not verified. No operator has completed the flow in this repo's record.
- Plans: MCP is available on Pro, Team and Enterprise; Free is excluded. State "MCP starts at Pro".
- The exact Free denial status/payload/UX is UNVERIFIED. Do not guess failure semantics.
- No reviewed source documents different MCP tool sets per paid tier. Do not invent per-tool tier gates.
- Per-plan usage caps within eligible tiers are undocumented. Finance+ is a separate paid add-on, and its MCP result coverage is unestablished.
- Rate limit: 60 requests per 60 seconds per user; on 429 honor
Retry-After, then exponential backoff with jitter.
- Transport: the provider itself is a hosted remote server over Streamable HTTP at
https://api.mobbin.com/mcp — there is no local package to install; the official repo is metadata-only. The local bridge is npx -y mcp-remote over stdio (HTTP-first, SSE fallback only on HTTP 404; experimental, externally versioned; Node 18+ and working npx are prerequisites).
4. RULES
✅ ALWAYS
- ALWAYS confirm callables with
tool_info before first use. The mobbin.mobbin_search_screens form is CONFIRMED by live discovery 2026-07-16 (fixture references/discovery-fixture-2026-07-16.json; registry names are dotted mobbin.mobbin.<tool>). Fail closed on any drift from the live three-tool baseline (search_screens, search_flows, search_sections).
- ALWAYS route measured-extraction needs to
sk-design-md-generator. Pair it when a measured Style Reference is also wanted.
- This packet is the transport.
sk-design-md-generator is its cross-hub measured-extraction companion. It turns a live site's real CSS into a Style Reference DESIGN.md of named design tokens.
- Transport output is Mobbin screenshot evidence. It is never a design-token set or Style Reference by itself.
- ALWAYS report the manual's registration state honestly. The
mobbin manual is registered in .utcp_config.json: presence means verify read-only and proceed to discovery; absence is a failure symptom (a broken or reverted registration) to escalate to the operator, never to repair from this packet.
- ALWAYS follow the documented input contract:
query from the user's actual words, platform ios|web (infer from context; unclear -> ask), limit starting at 5 and never exceeding ~15 without asking. Preserve unknown response fields untouched.
- ALWAYS cite evidence by
mobbin_url and report failed[] entries and missing images as partial success, never silently discarding them.
- ALWAYS treat this packet as read-only against this repo (
mutatesWorkspace: false). All reads happen against the external Mobbin service; Write, Edit, and Task are forbidden tools for this transport.
⛔ NEVER
- NEVER use Write, Edit, or Task through this packet. It is a TRANSPORT: it retrieves external evidence and changes nothing in this workspace. Hand file changes to the owning workflow skill.
- NEVER edit, re-draft, or re-add the
mobbin manual in .utcp_config.json. The registered entry is operator-owned. The reference shape in assets/utcp-mobbin-manual.md exists for verification and escalation, not for this packet to apply or repair.
- NEVER invent an API key or auth env var. No
MOBBIN_API_KEY or any MCP auth env var exists — the manual's env stays empty, and the auth env-var question is answered in the negative, not open. Never accept credentials in prompts or tool arguments; never print Authorization headers, OAuth codes, token responses, adapter debug logs, or auth-cache contents.
- NEVER claim OAuth works end-to-end. It is Inferred pending an operator-completed authorization; report it as such. Never inspect, clear, or repair
~/.mcp-auth / MCP_REMOTE_CONFIG_DIR — reauthorization is an explicit operator action.
- NEVER invent tool schemas or tool families beyond the discovered inventory. The live pre-auth listing on 2026-07-16 contains exactly
search_screens, search_flows and search_sections.
- No
search_apps, search_elements, detail, image-download or mutation tools exist to call.
- The
deep question is resolved: mode: "deep" | "standard" | "fast" is a real client input on search_screens. Do not assume undeclared parameters on any tool.
- NEVER target
docs.mobbin.com/mcp. That is a separate Mintlify docs-search MCP; the design-reference server this packet owns is api.mobbin.com/mcp only. Likewise never conflate the OAuth MCP with the separate API-key REST API.
- NEVER treat search rank or image appeal as a taste verdict, never average strong references into a generic middle, and never copy or cache third-party reference content (screenshots, images) into this repo.
⚠️ ESCALATE IF
- ESCALATE IF authentication is required (HTTP 401 beyond the expected pre-auth challenge, OAuth prompt, browser round-trip). Completing browser OAuth is operator-only; surface the step and wait. Headless sessions need an operator-visible escalation, never a workaround.
- ESCALATE IF discovery shows catalog drift: a different callable name than the inferred form, unexpected new tools, or any mutation-capable tool. Refuse mutation-capable tools outright; a provider-surface change requires a reviewed packet update.
- ESCALATE IF the account is Free-tier or rate-limited (entitlement denial or 429 beyond the
Retry-After + backoff protocol), reporting the provider's message verbatim without guessing denial semantics.
- ESCALATE IF the manual is missing or malformed in
.utcp_config.json. The registered entry is operator-owned; a broken or reverted registration is reported with the reference shape in the asset, and any config change stops with the operator.
- ESCALATE IF retrieved Mobbin evidence conflicts with a
sk-design-md-generator Style Reference (its extracted design tokens), asking which source prevails before any conclusion is drawn.
5. REFERENCES
Core References
- tool-surface.md - The live three-tool contract (fixture schemas for
search_screens, search_flows, search_sections), the resolved deep mode, the query-intent workflows, plan gating, the completeness boundary, and the open questions.
- mcp-wiring.md - The registered
mobbin manual, the mcp-remote bridge (remote Streamable HTTP vs local stdio adapter), OAuth/DCR/PKCE, the confirmed naming (2026-07-16 fixture), and the discovery-first contract, with CONFIRMED/INFERRED/UNKNOWN tagging.
- troubleshooting.md - Failure modes and fixes (pre-auth 401, no tools resolving, 429, Free-account denial, drift).
Templates and Assets
- utcp-mobbin-manual.md - The registered manual's reference shape exactly as researched (registered 2026-07-16, byte-identical to the live config), plus the post-registration checklist (doc-side items executed; live items pending).
Reference Loading Notes
tool-surface.md is the baseline (always). Load mcp-wiring.md and the manual asset for wiring/auth intent, troubleshooting.md for errors.
- Keep Section 2 (SMART ROUTING) as the routing summary and the sibling
ROUTER.md as the single machine route map.
6. SUCCESS CRITERIA
Wiring reporting complete when:
- ✅ The manual's registration state was reported honestly (presence verified read-only; absence escalated as a failure), nothing in
.utcp_config.json was touched, and discovery (list_tools / tool_info) either confirmed the callable or the session/auth/entitlement blocker was escalated to the operator.
Retrieval complete when:
- ✅ Discovery preceded any call, the documented input contract was honored (
query, platform, limit starting at 5), results were cited by mobbin_url, failed[] and missing images were reported as partial success, and no invented tool or parameter was used.
Measured-reference pairing complete when:
- ✅
sk-design-md-generator owned any measured Style Reference (extracted design tokens), the transport supplied only requested Mobbin evidence, and no design-token set or Style Reference was fabricated from transport output.
Always:
- ✅ No workspace file changed, no credential was invented, printed, or cached, no auth state was touched, no unpublished limit or schema was invented, and every capability claim stayed within the documented record or was labeled Inferred/UNKNOWN.
7. INTEGRATION POINTS
Tool Usage Guidelines
- Code Mode (
mcp__code_mode__call_tool_chain) owns every Mobbin call, including discovery (list_tools, search_tools, tool_info) — the registered manual resolves in a fresh Code Mode session (manuals load at startup).
- Read/Grep/Glob load references and check the manual's registration state in
.utcp_config.json read-only.
- Bash runs only the read-only
scripts/doctor.sh diagnostics; this transport has no other shell role (Code Mode owns the stdio process launch, so the packet never runs npx itself).
Cross-Workflow Contracts
sk-design-md-generator is the cross-hub measured-extraction companion. It turns a live website's real CSS into a Style Reference DESIGN.md of named design tokens, including type scale, components and Quick-Start CSS/Tailwind.
- This packet retrieves cited Mobbin screens through Code Mode as reference evidence.
sk-design-md-generator produces the measured Style Reference of tokens extracted from an actual live site.
- The transport issues no design tokens or Style Reference of its own. Pure setup/doctor or factual tool-surface reporting stays purely retrieval.
mcp-code-mode is the substrate: manuals, {manual}.{manual}_{tool} naming, discovery, and the error-envelope discipline all come from it. The current local config surface documents stdio/sse manual shapes, which is why the registered manual bridges through mcp-remote rather than declaring direct Streamable HTTP.
mcp-refero is the closest sibling: another remote-MCP-via-mcp-remote, read-only, OAuth-gated design-research transport in this hub. mcp-figma is the hub's original Figma transport. Neither overlaps this packet's Mobbin surface.
External Tools
- Mobbin MCP (
https://api.mobbin.com/mcp): the external, paid, hosted design-research service (manifest identity com.mobbin/mobbin v1.0.1; provider transport Streamable HTTP). Not vendored, not mirrored, no local package exists.
- mcp-remote (npm, experimental, externally versioned): the stdio-to-HTTP bridge Code Mode launches via
npx from the registered manual. HTTP-first transport strategy with SSE fallback only on HTTP 404; Node 18+ required.
- Official Mobbin skills repo (
github.com/mobbin/skills, MIT): contains exactly one skill, mobbin-search, the authoritative usage contract for search_screens. npx skills add mobbin/skills installs guidance only; it does not replace the MCP manual or OAuth.
Knowledge Base Dependencies
Required: references/tool-surface.md (tool contract baseline). Conditional: mcp-wiring.md + assets/utcp-mobbin-manual.md (wiring/auth), troubleshooting.md (errors).
8. QUICK REFERENCE
| Item |
Value |
| Endpoint |
https://api.mobbin.com/mcp (hosted remote, Streamable HTTP; local bridge npx -y mcp-remote) |
| Manual |
mobbin — REGISTERED in .utcp_config.json (2026-07-16); discovery DONE 2026-07-16 pre-auth (references/discovery-fixture-2026-07-16.json); OAuth pends the operator for CALLS (reference shape in assets/utcp-mobbin-manual.md) |
| Callable form |
mobbin.mobbin_search_screens(...) — CONFIRMED 2026-07-16; registry names dotted mobbin.mobbin.<tool>; re-confirm via tool_info per session |
| Tool surface |
THREE live tools: search_screens (query, platform "ios"|"web", mode "deep"|"standard"|"fast", limit, exclude_screen_ids, image_format), search_flows (query, platform, limit, page), search_sections (query, limit, page) |
| Result |
Declared: search_screens {query, screens[{id, app_name, mobbin_url, image_url, platform}]}; search_flows/search_sections add page, has_next_page; live response shape untested pre-OAuth |
| Workflows |
Apps / screens / elements = query intents over search_screens; flows = search_flows; website sections = search_sections |
| Auth |
Browser OAuth (DCR, PKCE S256, openid) — no API key, no auth env var; state in ~/.mcp-auth, operator-owned |
| Plans |
Free: NO MCP · Pro/Team/Enterprise: MCP eligible; per-plan caps undocumented |
| Rate limit |
60 requests / 60 seconds / user; on 429 honor Retry-After, then backoff with jitter |
| Open items |
Authenticated calls + live response shapes unexercised; OAuth end-to-end Inferred; inline-image fidelity through call_tool_chain UNKNOWN (naming + inventory + deep mode: resolved 2026-07-16) |
| Measured reference |
sk-design-md-generator for a Style Reference of extracted design tokens |
9. REFERENCES AND RELATED RESOURCES
The router (ROUTER.md) discovers reference and asset docs dynamically. Start from references/tool-surface.md for the tool contract and workflows, references/mcp-wiring.md for the bridge and auth model, and references/troubleshooting.md for failures.
Assets: assets/utcp-mobbin-manual.md (the registered manual's reference shape, byte-identical to the researched sol/luna drafts and to the live .utcp_config.json entry), loaded for wiring/auth intent.
Scripts: scripts/doctor.sh (read-only, non-interactive diagnostics; manual absence now reported as an ERROR — a broken or reverted registration; optional endpoint probe gated behind MOBBIN_DOCTOR_LIVE=1, expecting the documented HTTP 401) and scripts/install.sh (non-interactive verify-only posture check: Node 18+/npx, manual presence, and the operator-only OAuth pointer).
Examples: examples/README.md plus worked Code Mode walkthroughs (smoke search, platform-filtered flow research, element intent), all quoting the 2026-07-16 discovery-confirmed callables with the mandatory per-session tool_info confirmation first.
Related skills: sk-design-md-generator (the measured-extraction companion), mcp-code-mode (the substrate), mcp-refero (the closest sibling transport), mcp-figma (the hub's Figma transport), mcp-chrome-devtools (browser preview only), sk-code (adapting evidence into an app), and system-spec-kit when packet documentation or memory continuity applies.
Install guide: INSTALL-GUIDE.md.
Upstream: the Mobbin MCP is the hosted paid service at api.mobbin.com/mcp (docs at docs.mobbin.com/mcp; the official mobbin/mobbin-mcp-server repository is registration metadata only). The official mobbin/skills repository (MIT) holds the single mobbin-search skill; this packet references it and deliberately does not vendor it.
1---2name: mcp-mobbin3description: "Mobbin MCP transport: read-only app/screen/flow research via Code Mode, paired with sk-design-md-generator for a Style Reference."4compatibility: Requires a paid Mobbin plan for MCP (Pro, Team, or Enterprise; Free has no MCP access), the npx mcp-remote bridge, Node.js >=18, and a browser OAuth round-trip on first use.5allowed-tools: [Read, Bash, Grep, Glob, mcp__code_mode__call_tool_chain]6version: 1.1.7.07user-invocable: true8metadata:9 source: https://skillmd.com/skills/michelkerkmeester/mcp-mobbin10---1112# Mobbin (mcp-mobbin)1314Search **Mobbin's library of real app UI screenshots**. The official repo calls it "the world's largest library of real app UI screenshots". An agent can query it through the **Mobbin MCP via Code Mode**. Its documented tool is `search_screens`, which answers app, screen, flow and element research as query intents.15This packet is a read-only TRANSPORT (`packetKind: transport`, `mutatesWorkspace: false`). Every call goes to the external hosted Mobbin service, never this repo. It **produces no design tokens or Style Reference of its own**. If you also want a measured Style Reference of real, extracted design tokens, pair it with `sk-design-md-generator`.16Deep operational detail lives in [`references/tool-surface.md`](references/tool-surface.md) and [`references/mcp-wiring.md`](references/mcp-wiring.md).1718> **Discovery status (read first).** The `mobbin` Code Mode manual **IS REGISTERED** in this repo's `.utcp_config.json`. An operator registered it on 2026-07-16. This packet never edits the config.19>20> **Live discovery RAN 2026-07-16, pre-auth** (fixture: `references/discovery-fixture-2026-07-16.json`).21> `list_tools` returned **THREE** read tools. Registry names are `mobbin.mobbin.{search_screens,search_flows,search_sections}` (dot-separated).22> The fixture's `Access as:` lines show TypeScript callables such as `mobbin.mobbin_search_screens(...)`. This supersedes the research's one-public-tool baseline.23>24> Operator browser OAuth is still pending for CALLS. Per-session `tool_info` re-confirmation is MANDATORY before relying on any name. Confirm, then call. Fail closed on drift.25>26> **Access trap.** Mobbin MCP access is documented for **Pro, Team, and Enterprise — not Free**. Authentication is **browser OAuth only** (DCR + PKCE S256, `openid` scope): **no static API key or auth env var exists for MCP** — that question is answered in the negative, not open. Unauthenticated calls return HTTP 401. The service is rate-limited to **60 requests per 60 seconds per user**.2728---2930## 1. WHEN TO USE3132### Activation Triggers3334**Use when** the user wants to:35- Search Mobbin for real-app design references: screens for a UI pattern or state, apps for category comparison, flows for journey steps, or elements for component behavior in context.36- Find screen examples from shipped apps ("show me iOS banking onboarding screens", "web empty-state dashboard examples").37- Research how real products handle a flow or journey through screen evidence ("first-run onboarding progression", "forgot-password recovery").38- Wire, verify, or troubleshoot the registered `mobbin` Code Mode manual, its OAuth authentication, its plan gating, or its rate limit.3940**Keyword Triggers**: "mobbin", "mobbin mcp", "app design research", "screen examples", "ux flow references", "real app screenshots", "search mobbin".4142### Use Cases4344**App research (read-only).** Name the app, company, or category plus the comparison goal ("banking apps onboarding identity verification"); compare `app_name`, platform, structure, and visible patterns across results. Multiple results are evidence, not a design chooser.4546**Screen research (read-only).** Name the concrete screen, state, or job ("iOS subscription cancellation confirmation"); start at 5 results; cite each `mobbin_url` used.4748**Flow research (read-only).** Describe the journey and target step. The public contract returns screens, not an ordered flow object — reconstruct sequence only when visual evidence supports it, and label the reconstruction as inference.4950**Element research (read-only).** Name component plus context/state ("bottom-sheet destructive confirmation", "inline validation on signup"); analyze element behavior within returned screens.5152**Wiring and auth verification.** Report the manual's registration state honestly (presence is the healthy result; absence is a failure symptom to escalate), explain the OAuth-only model and plan gate, and never repair auth state yourself.5354### When NOT to Use5556**Skip this skill when:**57- The work is measured design-reference extraction: turning a live website's real CSS into a Style Reference DESIGN.md of named design tokens (type scale, components, Quick-Start CSS/Tailwind). That is `sk-design-md-generator`; this packet only retrieves Mobbin screenshot evidence.58- The task is styles, screens, or flows research through Refero. That is `mcp-refero`, the sibling transport.59- The task is Figma work (inspect, tokens, render, Code Connect). That is `mcp-figma`.60- The task is browser automation, live-page inspection, or visual preview of a built page. That is `mcp-chrome-devtools`.61- The work is generic app coding with no design-reference input: use `sk-code`.62- The target is Mobbin's documentation search. `docs.mobbin.com/mcp` is a **separate** Mintlify docs-search MCP, not the design-reference server; this packet targets `api.mobbin.com/mcp` only.63- The user asks to change this repo's files, edit the registered `.utcp_config.json` manual, or repair auth state. This transport forbids Write/Edit/Task, never mutates the workspace, and the registered manual is operator-owned.6465---6667## 2. SMART ROUTING6869The `mcp-tooling` hub routes a Mobbin request here when the prompt names Mobbin or asks for app design research, real app screenshots or UX flow references, and the hub's `mcp-mobbin` signal selects this packet.70Generic design, UI or screen phrasing is not a Mobbin signal: measured extraction belongs to `sk-design-md-generator`, Refero references to `mcp-refero`, Figma work to `mcp-figma`, and browser work to `mcp-chrome-devtools`.7172`references/tool-surface.md` is the research baseline and loads for every research intent, `references/mcp-wiring.md` and `assets/utcp-mobbin-manual.md` load for wiring or auth intent, and `references/troubleshooting.md` for setup and error intent.7374A request that scores no intent returns `UNKNOWN_FALLBACK` with its disambiguation checklist, never a silent default.7576Read [`ROUTER.md`](./ROUTER.md) before selecting skill-local resources; open only the matched files.7778---7980## 3. HOW IT WORKS8182### First Step (Always): report the wiring state honestly8384The `mobbin` manual is registered in this repo's `.utcp_config.json`. An operator registered it on 2026-07-16, not this packet.85`scripts/doctor.sh` reports the state without changing it. Manual presence is healthy. Absence is now an ERROR. Escalate a missing registration as broken or reverted; never repair it here.86Manuals load at Code Mode startup, and OAuth is still pending. Discovery through a fresh Code Mode session is mandatory before any call:8788```typescript89// Live-confirmed dotted discovery names (2026-07-16 fixture):90// mobbin.mobbin.search_screens · mobbin.mobbin.search_flows · mobbin.mobbin.search_sections91const all = await list_tools();92// MANDATORY per session: confirm the exact callable + schema before relying on any name93const info = await tool_info({ tool_name: "mobbin.mobbin_search_screens" });94```9596Live discovery on 2026-07-16 **CONFIRMED both the dotted discovery names and the callable form** (`references/discovery-fixture-2026-07-16.json`). The convention-derived prediction held exactly.97Discovery ran **pre-auth**: `tools/list` and schemas needed no OAuth. Authenticated CALLS remain operator-gated.98If future discovery shows different names, missing tools, unexpected new tools or a mutation-capable tool, **fail closed**. Report the drift. A changed provider surface requires a reviewed packet update, not an improvised call.99100### The live three-tool surface (supersedes the one-tool baseline, 2026-07-16)101102The research's **one publicly documented tool** baseline is superseded: live pre-auth discovery on 2026-07-16 listed **three** read-only search tools. All three passed the mutation-refusal check (no mutation-capable tool in the listing). Full fixture schemas and the completeness boundary: [`references/tool-surface.md`](references/tool-surface.md).103104| Tool | Posture | Required inputs (fixture schema) | Optional inputs (fixture schema) |105|---|---|---|---|106| `search_screens` | Read/search | `query`; `platform` `"ios"`\|`"web"` | `mode` `"deep"`\|`"standard"`\|`"fast"` (deprecated alias); `limit`; `exclude_screen_ids[]`; `image_format` `"webp"`\|`"jpg"` |107| `search_flows` | Read/search | `query` (one journey); `platform` `"ios"`\|`"web"` | `limit`; `page` (max 20); `image_format` |108| `search_sections` | Read/search | `query` (one website section) | `limit`; `page`; `image_format` |109110Declared `search_screens` output (fixture): `{ query, screens: [{ id, image_url, mobbin_url, app_name, platform }] }`.111The research-documented `index`/`failed[]` fields do not appear in the declared schema. Verify the actual response shape on the first authenticated call.112**The `deep` conflict is RESOLVED**. Search mode is a client-settable input on `search_screens`: `"deep"` means an AI-powered relevance pipeline for nuanced queries, `"standard"` means low latency and `"fast"` is a deprecated alias for standard.113Never invent `search_apps`, `search_elements` or any detail, image-download or mutation tool beyond the discovered inventory.114115### Calling through Code Mode116117> **Callable-name status.** Live discovery on 2026-07-16 confirmed the callable form (`references/discovery-fixture-2026-07-16.json`). The registry name is `mobbin.mobbin.search_screens`, and the TypeScript callable is `mobbin.mobbin_search_screens(args)`.118> The call below uses the confirmed form. Live RESPONSE behavior remains unexercised because authenticated calls await operator OAuth. Re-confirm the name with `tool_info` in each session.119120Mandatory discovery-first sequence: `list_tools()` or `search_tools({ task_description: "Mobbin screen design research", limit: 10 })` -> filter to the `mobbin` manual -> `tool_info()` on the exact dotted name -> only then `call_tool_chain({ code })`. Cite every selected reference by its `mobbin_url`.121122```typescript123call_tool_chain({124 code: `125 const result = await mobbin.mobbin_search_screens({126 query: "iOS banking app onboarding identity verification",127 platform: "ios",128 limit: 5129 });130 return { success: true, data: result, errors: [], timestamp: new Date().toISOString() };131 `132});133```134135### Research workflows (query intents over the three live tools)136137App, screen, and element research remain intent-specific query designs over `search_screens`; flow and website-section research now have dedicated live-discovered tools (2026-07-16):1381391. **App research** — name the app/company/category and comparison goal ("banking apps onboarding identity verification"); compare `app_name`, platform, structure, visible patterns.1402. **Screen research** — name the concrete screen/state/job ("iOS subscription cancellation confirmation", "web empty-state dashboard"); start at 5 results; cite each `mobbin_url` used.1413. **Flow research** — use `search_flows`: describe one user journey ("onboarding with personalization steps"); it returns ordered flow objects (`screens[].position`, `actions[]`, `screen_count`), superseding the old screens-only reconstruction guidance. Label anything beyond the returned ordering as inference.1424. **Element research** — name component + context/state ("bottom-sheet destructive confirmation", "inline validation on signup"); analyze element behavior within returned screens; never fabricate an element-detail tool.1435. **Website-section research** — use `search_sections`: describe one section ("pricing page with plan comparison table"); results carry `site_name` and section images.144145Official skill operating sequence:1461. Derive query terms from the user's actual words.1472. Infer `ios` or `web` from app context. If unclear, ask.1483. Announce a short search plan.1494. Call `search_screens` in the same turn.1505. Visually inspect returned references for content, structure, styling and interaction. Compare repeats and meaningful differences, then synthesize principles.1516. Answer from evidence tied to returned screens.152153The official skill's optional evidence-board writer is **excluded** from this transport because the transport has a read-only boundary.154155Context discipline: start `limit: 5`; ask before widening materially (do not exceed ~15 just for variety); report `failed[]` entries and missing images as partial success, never silently discard; retain `mobbin_url` as provenance for every selected reference.156157### Auth, plans, and limits158159- **Auth**: Browser OAuth is the only auth method: protected-resource discovery, Dynamic Client Registration (RFC 7591), authorization-code + PKCE S256 and `openid` scope.160 - **No static Mobbin API key exists for MCP.** The API-key Bearer model belongs to the separate Team/Enterprise REST API. Never conflate the two.161 - Client access is revocable from Mobbin Account Settings -> MCP.162 - Adapter auth state persists under `~/.mcp-auth` (or `MCP_REMOTE_CONFIG_DIR`) and is **operator-owned**. Never inspect, clear or repair it.163 - A live unauthenticated probe returned HTTP 401 with a `WWW-Authenticate` pointer to the protected-resource metadata. A pre-authorization 401 is the **expected** challenge, not a missing-key error.164 - End-to-end OAuth through the local Code Mode + `mcp-remote` bridge is **Inferred**, not verified. No operator has completed the flow in this repo's record.165- **Plans**: MCP is available on **Pro, Team and Enterprise**; Free is excluded. State "MCP starts at Pro".166 - The exact Free denial status/payload/UX is UNVERIFIED. Do not guess failure semantics.167 - No reviewed source documents different MCP tool sets per paid tier. Do not invent per-tool tier gates.168 - Per-plan usage caps within eligible tiers are undocumented. Finance+ is a separate paid add-on, and its MCP result coverage is unestablished.169- **Rate limit**: **60 requests per 60 seconds per user**; on 429 honor `Retry-After`, then exponential backoff with jitter.170- **Transport**: the provider itself is a hosted remote server over **Streamable HTTP** at `https://api.mobbin.com/mcp` — there is no local package to install; the official repo is metadata-only. The local bridge is `npx -y mcp-remote` over stdio (HTTP-first, SSE fallback only on HTTP 404; experimental, externally versioned; Node 18+ and working `npx` are prerequisites).171172---173174## 4. RULES175176### ✅ ALWAYS1771781. **ALWAYS confirm callables with `tool_info` before first use.** The `mobbin.mobbin_search_screens` form is **CONFIRMED by live discovery 2026-07-16** (fixture `references/discovery-fixture-2026-07-16.json`; registry names are dotted `mobbin.mobbin.<tool>`). Fail closed on any drift from the live three-tool baseline (`search_screens`, `search_flows`, `search_sections`).1792. **ALWAYS route measured-extraction needs to `sk-design-md-generator`. Pair it when a measured Style Reference is also wanted.**180 - This packet is the transport.181 - `sk-design-md-generator` is its cross-hub measured-extraction companion. It turns a live site's real CSS into a Style Reference DESIGN.md of named design tokens.182 - Transport output is Mobbin screenshot evidence. It is never a design-token set or Style Reference by itself.1833. **ALWAYS report the manual's registration state honestly.** The `mobbin` manual is registered in `.utcp_config.json`: presence means verify read-only and proceed to discovery; absence is a **failure symptom** (a broken or reverted registration) to escalate to the operator, never to repair from this packet.1844. **ALWAYS follow the documented input contract**: `query` from the user's actual words, `platform` `ios`|`web` (infer from context; unclear -> ask), `limit` starting at 5 and never exceeding ~15 without asking. Preserve unknown response fields untouched.1855. **ALWAYS cite evidence by `mobbin_url`** and report `failed[]` entries and missing images as partial success, never silently discarding them.1866. **ALWAYS treat this packet as read-only against this repo** (`mutatesWorkspace: false`). All reads happen against the external Mobbin service; Write, Edit, and Task are forbidden tools for this transport.187188### ⛔ NEVER1891901. **NEVER use Write, Edit, or Task through this packet.** It is a TRANSPORT: it retrieves external evidence and changes nothing in this workspace. Hand file changes to the owning workflow skill.1912. **NEVER edit, re-draft, or re-add the `mobbin` manual in `.utcp_config.json`.** The registered entry is operator-owned. The reference shape in [`assets/utcp-mobbin-manual.md`](assets/utcp-mobbin-manual.md) exists for verification and escalation, not for this packet to apply or repair.1923. **NEVER invent an API key or auth env var.** No `MOBBIN_API_KEY` or any MCP auth env var exists — the manual's `env` stays empty, and the auth env-var question is answered in the negative, not open. Never accept credentials in prompts or tool arguments; never print Authorization headers, OAuth codes, token responses, adapter debug logs, or auth-cache contents.1934. **NEVER claim OAuth works end-to-end.** It is **Inferred** pending an operator-completed authorization; report it as such. Never inspect, clear, or repair `~/.mcp-auth` / `MCP_REMOTE_CONFIG_DIR` — reauthorization is an explicit operator action.1945. **NEVER invent tool schemas or tool families beyond the discovered inventory.** The live pre-auth listing on 2026-07-16 contains exactly `search_screens`, `search_flows` and `search_sections`.195 - No `search_apps`, `search_elements`, detail, image-download or mutation tools exist to call.196 - The `deep` question is resolved: `mode: "deep" | "standard" | "fast"` is a real client input on `search_screens`. Do not assume undeclared parameters on any tool.1976. **NEVER target `docs.mobbin.com/mcp`.** That is a separate Mintlify docs-search MCP; the design-reference server this packet owns is `api.mobbin.com/mcp` only. Likewise never conflate the OAuth MCP with the separate API-key REST API.1987. **NEVER treat search rank or image appeal as a taste verdict**, never average strong references into a generic middle, and never copy or cache third-party reference content (screenshots, images) into this repo.199200### ⚠️ ESCALATE IF2012021. **ESCALATE IF authentication is required** (HTTP 401 beyond the expected pre-auth challenge, OAuth prompt, browser round-trip). Completing browser OAuth is **operator-only**; surface the step and wait. Headless sessions need an operator-visible escalation, never a workaround.2032. **ESCALATE IF discovery shows catalog drift**: a different callable name than the inferred form, unexpected new tools, or any mutation-capable tool. Refuse mutation-capable tools outright; a provider-surface change requires a reviewed packet update.2043. **ESCALATE IF the account is Free-tier or rate-limited** (entitlement denial or 429 beyond the `Retry-After` + backoff protocol), reporting the provider's message verbatim without guessing denial semantics.2054. **ESCALATE IF the manual is missing or malformed in `.utcp_config.json`.** The registered entry is operator-owned; a broken or reverted registration is reported with the reference shape in the asset, and any config change stops with the operator.2065. **ESCALATE IF retrieved Mobbin evidence conflicts with a `sk-design-md-generator` Style Reference (its extracted design tokens)**, asking which source prevails before any conclusion is drawn.207208---209210## 5. REFERENCES211212### Core References213214- [tool-surface.md](references/tool-surface.md) - The live three-tool contract (fixture schemas for `search_screens`, `search_flows`, `search_sections`), the resolved `deep` mode, the query-intent workflows, plan gating, the completeness boundary, and the open questions.215- [mcp-wiring.md](references/mcp-wiring.md) - The registered `mobbin` manual, the mcp-remote bridge (remote Streamable HTTP vs local stdio adapter), OAuth/DCR/PKCE, the confirmed naming (2026-07-16 fixture), and the discovery-first contract, with CONFIRMED/INFERRED/UNKNOWN tagging.216- [troubleshooting.md](references/troubleshooting.md) - Failure modes and fixes (pre-auth 401, no tools resolving, 429, Free-account denial, drift).217218### Templates and Assets219220- [utcp-mobbin-manual.md](assets/utcp-mobbin-manual.md) - The registered manual's reference shape exactly as researched (registered 2026-07-16, byte-identical to the live config), plus the post-registration checklist (doc-side items executed; live items pending).221222### Reference Loading Notes223224- `tool-surface.md` is the baseline (always). Load `mcp-wiring.md` and the manual asset for wiring/auth intent, `troubleshooting.md` for errors.225- Keep Section 2 (SMART ROUTING) as the routing summary and the sibling [`ROUTER.md`](./ROUTER.md) as the single machine route map.226227---228229## 6. SUCCESS CRITERIA230231**Wiring reporting complete when:**232- ✅ The manual's registration state was reported honestly (presence verified read-only; absence escalated as a failure), nothing in `.utcp_config.json` was touched, and discovery (`list_tools` / `tool_info`) either confirmed the callable or the session/auth/entitlement blocker was escalated to the operator.233234**Retrieval complete when:**235- ✅ Discovery preceded any call, the documented input contract was honored (`query`, `platform`, `limit` starting at 5), results were cited by `mobbin_url`, `failed[]` and missing images were reported as partial success, and no invented tool or parameter was used.236237**Measured-reference pairing complete when:**238- ✅ `sk-design-md-generator` owned any measured Style Reference (extracted design tokens), the transport supplied only requested Mobbin evidence, and no design-token set or Style Reference was fabricated from transport output.239240**Always:**241- ✅ No workspace file changed, no credential was invented, printed, or cached, no auth state was touched, no unpublished limit or schema was invented, and every capability claim stayed within the documented record or was labeled Inferred/UNKNOWN.242243---244245## 7. INTEGRATION POINTS246247### Tool Usage Guidelines248249- **Code Mode** (`mcp__code_mode__call_tool_chain`) owns every Mobbin call, including discovery (`list_tools`, `search_tools`, `tool_info`) — the registered manual resolves in a fresh Code Mode session (manuals load at startup).250- **Read/Grep/Glob** load references and check the manual's registration state in `.utcp_config.json` read-only.251- **Bash** runs only the read-only `scripts/doctor.sh` diagnostics; this transport has no other shell role (Code Mode owns the stdio process launch, so the packet never runs `npx` itself).252253### Cross-Workflow Contracts254255- **`sk-design-md-generator`** is the cross-hub measured-extraction companion. It turns a live website's real CSS into a Style Reference DESIGN.md of named design tokens, including type scale, components and Quick-Start CSS/Tailwind.256 - This packet retrieves cited Mobbin screens through Code Mode as reference evidence.257 - `sk-design-md-generator` produces the measured Style Reference of tokens extracted from an actual live site.258 - The transport issues no design tokens or Style Reference of its own. Pure setup/doctor or factual tool-surface reporting stays purely retrieval.259- **`mcp-code-mode`** is the substrate: manuals, `{manual}.{manual}_{tool}` naming, discovery, and the error-envelope discipline all come from it. The current local config surface documents `stdio`/`sse` manual shapes, which is why the registered manual bridges through `mcp-remote` rather than declaring direct Streamable HTTP.260- **`mcp-refero`** is the closest sibling: another remote-MCP-via-`mcp-remote`, read-only, OAuth-gated design-research transport in this hub. **`mcp-figma`** is the hub's original Figma transport. Neither overlaps this packet's Mobbin surface.261262### External Tools263264- **Mobbin MCP** (`https://api.mobbin.com/mcp`): the external, paid, hosted design-research service (manifest identity `com.mobbin/mobbin` v1.0.1; provider transport Streamable HTTP). Not vendored, not mirrored, no local package exists.265- **mcp-remote** (npm, experimental, externally versioned): the stdio-to-HTTP bridge Code Mode launches via `npx` from the registered manual. HTTP-first transport strategy with SSE fallback only on HTTP 404; Node 18+ required.266- **Official Mobbin skills repo** (`github.com/mobbin/skills`, MIT): contains exactly one skill, `mobbin-search`, the authoritative usage contract for `search_screens`. `npx skills add mobbin/skills` installs guidance only; it does not replace the MCP manual or OAuth.267268### Knowledge Base Dependencies269270**Required**: `references/tool-surface.md` (tool contract baseline). **Conditional**: `mcp-wiring.md` + `assets/utcp-mobbin-manual.md` (wiring/auth), `troubleshooting.md` (errors).271272---273274## 8. QUICK REFERENCE275276| Item | Value |277|---|---|278| Endpoint | `https://api.mobbin.com/mcp` (hosted remote, Streamable HTTP; local bridge `npx -y mcp-remote`) |279| Manual | `mobbin` — **REGISTERED** in `.utcp_config.json` (2026-07-16); discovery DONE 2026-07-16 pre-auth (`references/discovery-fixture-2026-07-16.json`); OAuth pends the operator for CALLS (reference shape in `assets/utcp-mobbin-manual.md`) |280| Callable form | `mobbin.mobbin_search_screens(...)` — **CONFIRMED 2026-07-16**; registry names dotted `mobbin.mobbin.<tool>`; re-confirm via `tool_info` per session |281| Tool surface | THREE live tools: `search_screens` (`query`, `platform` `"ios"`\|`"web"`, `mode` `"deep"`\|`"standard"`\|`"fast"`, `limit`, `exclude_screen_ids`, `image_format`), `search_flows` (`query`, `platform`, `limit`, `page`), `search_sections` (`query`, `limit`, `page`) |282| Result | Declared: `search_screens` `{query, screens[{id, app_name, mobbin_url, image_url, platform}]}`; `search_flows`/`search_sections` add `page`, `has_next_page`; live response shape untested pre-OAuth |283| Workflows | Apps / screens / elements = query intents over `search_screens`; flows = `search_flows`; website sections = `search_sections` |284| Auth | Browser OAuth (DCR, PKCE S256, `openid`) — **no API key, no auth env var**; state in `~/.mcp-auth`, operator-owned |285| Plans | Free: NO MCP · Pro/Team/Enterprise: MCP eligible; per-plan caps undocumented |286| Rate limit | 60 requests / 60 seconds / user; on 429 honor `Retry-After`, then backoff with jitter |287| Open items | Authenticated calls + live response shapes unexercised; OAuth end-to-end Inferred; inline-image fidelity through `call_tool_chain` UNKNOWN (naming + inventory + `deep` mode: resolved 2026-07-16) |288| Measured reference | `sk-design-md-generator` for a Style Reference of extracted design tokens |289290---291292## 9. REFERENCES AND RELATED RESOURCES293294The router ([`ROUTER.md`](./ROUTER.md)) discovers reference and asset docs dynamically. Start from `references/tool-surface.md` for the tool contract and workflows, `references/mcp-wiring.md` for the bridge and auth model, and `references/troubleshooting.md` for failures.295296Assets: `assets/utcp-mobbin-manual.md` (the registered manual's reference shape, byte-identical to the researched sol/luna drafts and to the live `.utcp_config.json` entry), loaded for wiring/auth intent.297298Scripts: `scripts/doctor.sh` (read-only, non-interactive diagnostics; manual absence now reported as an ERROR — a broken or reverted registration; optional endpoint probe gated behind `MOBBIN_DOCTOR_LIVE=1`, expecting the documented HTTP 401) and `scripts/install.sh` (non-interactive verify-only posture check: Node 18+/npx, manual presence, and the operator-only OAuth pointer).299300Examples: `examples/README.md` plus worked Code Mode walkthroughs (smoke search, platform-filtered flow research, element intent), all quoting the 2026-07-16 discovery-confirmed callables with the mandatory per-session `tool_info` confirmation first.301302Related skills: `sk-design-md-generator` (the measured-extraction companion), `mcp-code-mode` (the substrate), `mcp-refero` (the closest sibling transport), `mcp-figma` (the hub's Figma transport), `mcp-chrome-devtools` (browser preview only), `sk-code` (adapting evidence into an app), and `system-spec-kit` when packet documentation or memory continuity applies.303304Install guide: [INSTALL-GUIDE.md](INSTALL-GUIDE.md).305306Upstream: the Mobbin MCP is the hosted paid service at `api.mobbin.com/mcp` (docs at docs.mobbin.com/mcp; the official `mobbin/mobbin-mcp-server` repository is registration metadata only). The official [mobbin/skills](https://github.com/mobbin/skills) repository (MIT) holds the single `mobbin-search` skill; this packet references it and deliberately does not vendor it.