WebMCP is a proposed web standard to help you build and expose structured tools for AI agents. It provides JavaScript and annotates HTML form elements so that agents know exactly how to interact with page features. Websites can share explicit purpose, such as search or purchasing, by defining a tool; tools execute on your webpage visibly, so users gain trust that tasks are completed as expected.

How do I get started with WebMCP?

Join the WebMCP origin trial from Chrome 149. For local development, open chrome://flags/#enable-webmcp-testing, set the flag to Enabled, and relaunch Chrome.

What are the two WebMCP APIs?

The Imperative API lets you define different types of tools with standard JavaScript, such as form input, navigation tools, state management, or other functions. The Declarative API lets you add annotations to standard HTML forms to create a WebMCP tool. Angular has experimental support for WebMCP, and you can debug WebMCP tools and validate how the browser parses the JSON Schema with Chrome DevTools.

How is WebMCP different from an agent clicking through my site?

Instead of an agent reviewing each element, such as a button or a field, to understand its purpose, the website defines tools with explicit purpose. This is more reliable than actuation, which may have numerous steps and leaves each step open to interpretation by the agent. WebMCP offers higher accuracy for agentic task completion and can be added as a progressive enhancement.

What are the limitations of WebMCP?

Headless browsing: the API is primarily designed for local browser workflows with a human in the loop. Overhead for complex interfaces: highly complex sites may need to refactor or add JavaScript to handle application and interface state. Tool discoverability: clients and browsers must visit a site directly to know if it has callable tools.

Does WebMCP work in cross-origin iframes?

Both APIs are gated by the tools Permissions Policy. The policy defaults to self, which allows tool registration in top-level and same-origin contexts and disables it for cross-origin iframes. To allow WebMCP tools in a cross-origin iframe, add the allow="tools" attribute to the iframe.

Google menggunakan teknologi AI untuk menerjemahkan konten ke dalam bahasa pilihan Anda. Terjemahan AI mungkin mengandung kesalahan.

WebMCP

Alexandra Klepper

François Beaufort

Kasper Kulikowski

Dipublikasikan: 18 Mei 2026, Terakhir diperbarui: 7 Oktober 2026

WebMCP adalah standar web yang diusulkan untuk membantu Anda membangun dan mengekspos alat terstruktur untuk agen AI. WebMCP menyediakan JavaScript dan memberi anotasi pada elemen formulir HTML sehingga agen tahu persis cara berinteraksi dengan fitur halaman, untuk mendukung pengalaman pengguna. Hal ini dapat meningkatkan performa dan keandalan aktuasi agen secara signifikan.

Agen AI adalah teknologi yang lebih baru. Agen ini dapat membantu pengguna manusia menyelesaikan tugas yang sangat kompleks dan teknis dengan lebih baik. WebMCP menawarkan akurasi yang lebih tinggi untuk penyelesaian tugas agentic, dan dapat ditambahkan sebagai progressive enhancement.

Penjelasan	Web	Ekstensi	Status Chrome	Intent
GitHub	Uji coba origin		View	Niat untuk Bereksperimen

Mengapa WebMCP?

WebMCP menyediakan aturan interaksi yang menjembatani kesenjangan antara aplikasi web dan agen, sehingga meningkatkan efisiensi, keandalan, dan penyelesaian tugas. Alih-alih agen meninjau elemen, seperti tombol atau kolom, untuk memahami tujuannya, situs mendeklarasikan tujuan elemen, sehingga digunakan sebagaimana mestinya.

Hal ini lebih andal daripada aktuasi, yang mungkin memiliki banyak langkah dan membuat setiap langkah terbuka untuk interpretasi oleh agen.

Di sebelah kiri, agen melakukan scraping DOM. Di sebelah kanan, agen memanggil alat. Cobalah sendiri di demo pembuatan janji temu kami.

Situs dapat membagikan tujuan eksplisit, seperti penelusuran atau pembelian, dengan menentukan tool. Alat dijalankan di halaman web Anda secara terlihat, sehingga pengguna yakin bahwa tugas diselesaikan seperti yang diharapkan. Hal ini juga menjaga merek dan pilihan desain yang berfokus pada pengguna tetap utuh.

WebMCP mendukung:

Penemuan: Cara standar bagi halaman untuk mendaftarkan alat ke agen, seperti checkout atau filter_results.
Skema JSON: Definisi eksplisit input dan output yang diharapkan, untuk mengurangi halusinasi atau kesalahpahaman.
Status: Pemahaman bersama tentang konteks halaman saat ini, sehingga agen mengetahui resource yang tersedia untuk ditindaklanjuti secara real time.

Tujuan kami adalah membangun API yang dapat diterapkan dan dimanfaatkan oleh browser apa pun dengan kemampuan agentic, sehingga pengguna Anda dapat menyelesaikan tugas dengan lebih mudah. Anda dapat mengikuti proses ini di GitHub.

Kasus penggunaan

Ada banyak cara untuk menggunakan WebMCP. Contoh:

Bantu pelanggan Anda mendapatkan dukungan. Jika Anda menyediakan software kepada pelanggan, Anda mungkin memiliki alur dukungan yang kompleks untuk menjawab berbagai pertanyaan. Anda dapat menggunakan WebMCP untuk membantu agen membuka formulir yang tepat dengan lebih cepat dan mengisi kolom dengan informasi yang diberikan pengguna.
Meningkatkan pemesanan perjalanan. Membantu agen memesan perjalanan yang kompleks, beberapa kota, dan beberapa penumpang dengan langkah yang lebih sedikit.

Beberapa tindakan mungkin bersifat sensitif, seperti melakukan pembelian. Anda dapat menyertakan perintah untuk meminta interaksi pengguna dengan dialog konfirmasi.

Secara praktis, alat Anda dapat menyelesaikan tugas-tugas berikut:

Mengisi formulir terstruktur: Buat alat submit_application untuk membantu agen memetakan data yang dikumpulkan dari percakapan dengan pengguna ke kolom formulir dengan benar. Misalnya, Anda dapat membedakan apakah kolom memerlukan nama lengkap atau nama depan dan belakang yang terpisah.
Mendukung interaksi agen dalam antarmuka yang mengutamakan manusia: Kolom tertentu dirancang untuk pengguna manusia, tetapi mungkin tidak dipahami oleh agen. Anda dapat membuat alat date_pick yang memungkinkan pemilihan tanggal dan waktu yang kompleks dalam reservasi atau pemesanan acara.
Proses debug aplikasi yang lebih cepat: Anda dapat membuat alat run_diagnostics di halaman setelan developer, sehingga agen dapat memicu perbaikan yang tersembunyi di balik menu bertingkat.

Apakah kasus penggunaan Anda tidak ada? Atau, apakah Anda memiliki ide yang ingin Anda bagikan untuk WebMCP? Ajukan pertanyaan dan berpartisipasi dalam diskusi di GitHub.

Mulai

Bergabunglah dengan uji coba origin WebMCP dari Chrome 149. Pelajari lebih lanjut cara mulai menggunakan uji coba origin.

WebMCP Lokal

WebMCP tersedia sebagai flag Chrome untuk pengembangan lokal:

Buka Chrome, lalu buka chrome://flags/#enable-webmcp-testing
Tetapkan flag ke Enabled.
Luncurkan kembali Chrome untuk menerapkan perubahan.

Menggunakan WebMCP API

Ada dua API yang dapat Anda gunakan untuk menyiapkan alat situs:

Imperative API: Menentukan berbagai jenis alat dengan JavaScript standar, seperti input formulir, alat navigasi, pengelolaan status, atau fungsi lainnya.
Declarative API: Menambahkan anotasi ke formulir HTML standar untuk membuat alat WebMCP.

Anda dapat men-debug alat WebMCP dan memvalidasi cara browser mengurai Skema JSON, dengan Chrome DevTools.

Batasan

Meskipun WebMCP bertujuan untuk menyederhanakan tugas yang kompleks bagi agen dan manusia, ada batasan:

Penjelajahan headless: Meskipun alat WebMCP dapat dijalankan di lingkungan headless, API ini terutama dirancang untuk alur kerja browser lokal yang memerlukan interaksi manusia.
Overhead untuk antarmuka yang kompleks: Jika situs Anda sangat kompleks, Anda mungkin perlu melakukan refaktorisasi atau menambahkan JavaScript untuk menangani status aplikasi dan antarmuka.
Visibilitas alat: Klien dan browser harus mengunjungi situs secara langsung untuk mengetahui apakah situs tersebut memiliki alat yang dapat dipanggil.

Kebijakan izin

Kedua API ini dibatasi oleh Kebijakan Izin tools. Kebijakan ini ditetapkan secara default ke self, yang mengizinkan pendaftaran alat dalam konteks tingkat teratas dan origin yang sama, serta menonaktifkannya untuk iframe lintas origin.

Untuk mengizinkan alat WebMCP di iframe lintas origin, tambahkan atribut allow="tools" ke iframe.

Demo

Contoh demo yang mencakup implementasi imperatif dan deklaratif tersedia:

WebMCP zaMaker menggunakan WebMCP Imperative API.
Demo perjalanan (React) menggunakan WebMCP Imperative API.
Demo Le Petit Bistro menggunakan WebMCP Declarative API.

Anda juga dapat meninjau dan mempelajari kode sumber demo di GitHub.

Meniru agen untuk menguji alat Anda

Kami telah membuat dua Ekstensi Chrome untuk membantu Anda melihat cara kerja alat WebMCP dalam demo kami dan aplikasi Anda.

Instal Ekstensi Chrome Agentic Contoh untuk memeriksa, memantau, dan menjalankan alat WebMCP dengan perintah bahasa alami. Secara khusus, ekstensi ini selalu memercayai anotasi WebMCP, yang dapat memberi tahu agen tentang tindakan sensitif. Hal ini menunjukkan bagaimana alat dapat berperforma secara berbeda dengan anotasi.

Secara default, ekstensi ini menggunakan server Node kecil dengan AI SDK. Kunci API diperlukan dan tetap berada di server lokal. Perintah Anda dikirim ke model gemini-3.6-flash secara default, tetapi Anda dapat mengubah pilihan model dan penyedia API di file .env ekstensi. Ada kolom untuk OpenAI, Google, dan Anthropic atau, sebagai alternatif, Anda dapat menyesuaikan ekstensi untuk menggunakan model dari penyedia lain.

Atau, Anda dapat menggunakan model sisi klien dengan Prompt API. Tindakan ini tidak memerlukan kunci API dan data tetap ada di perangkat Anda. Untuk melakukannya, aktifkan chrome://flags/#prompt-api-tool-use.

Instal Ekstensi Model Context Tool Inspector untuk bereksperimen dengan agen dan melihat cara kerja alat WebMCP dalam demo langsung atau aplikasi Anda sendiri. Gunakan perintah bahasa alami untuk menentukan apakah agen berinteraksi dengan alat WebMCP seperti yang diharapkan.

Untuk menggunakan Gemini guna memanggil alat, Anda harus memiliki kunci API, yang Anda berikan di antarmuka ekstensi. Perintah Anda dikirim secara default ke model gemini-3.6-flash. Anda dapat memilih model Gemini yang berbeda untuk bereksperimen atau menyesuaikan kode ekstensi untuk menggunakan model penyedia lain.

Berinteraksi dan memberikan masukan

WebMCP sedang dalam pembahasan aktif dan dapat berubah sewaktu-waktu pada masa mendatang. Jika Anda mencoba API ini dan memiliki masukan, kami ingin mendengarnya.

Bergabunglah dengan uji coba origin WebMCP, dan ikuti penerapan untuk Chrome di Chrome Status.
Baca penjelasan WebMCP, ajukan pertanyaan, dan berpartisipasi dalam diskusi.
Baca praktik terbaik WebMCP.
Baca panduan keamanan alat WebMCP dan praktik terbaik kami.
Jika Anda memiliki masukan tentang penerapan Chrome, laporkan bug Chromium.

Berikutnya

Imperative API