Agent Middleware MCP server
Commit 12 Nov 2026Menyediakan gateway aman untuk pemanggilan tool agent menggunakan signed permits, idempotency keys, dan verifiable offline receipts.
Juga dikenal sebagai agentmiddleware/agent-middleware
- Stars
- 1
- Tools
- —
- Unduhan, 30 hari
- —
- Versi terbaru
- —
- Commit terakhir
- 12 Nov 2026
- Lisensi
- Apache-2.0
Apa itu Agent Middleware MCP?
Agent Middleware adalah MCP server. Menyediakan gateway aman untuk pemanggilan tool agent menggunakan signed permits, idempotency keys, dan verifiable offline receipts.
Ringkasan dibuat dari README proyek
Tentang Agent Middleware MCP server
Mengamankan aksi agent berisiko tinggi seperti refund, payout, atau deployment adalah fungsi utama dari agent-middleware. Ini bertindak sebagai gateway yang ditempatkan di depan tool berisiko untuk memastikan setiap invokasi mengikuti tata kelola yang ketat. Developer dapat menggunakan ini sebagai local gateway melalui Makefile atau menghubungkan MCP client ke hosted endpoint menggunakan API key yang dikirimkan melalui header X-API-Key.
sistem ini mengandalkan beberapa konsep inti untuk menjaga kontrol. Sistem ini menggunakan permits, yaitu izin bertanda tangan yang menentukan tool, budget, dan waktu kedaluwarsa tertentu, serta idempotency keys untuk mencegah request duplikat. Setiap panggilan yang berhasil akan menghasilkan signed receipt yang berisi hash dari request dan response, sehingga memungkinkan verifikasi secara offline. Setup ini dirancang untuk developer yang perlu mengelola pemanggilan tool yang berdampak besar melalui protokol terstruktur daripada eksekusi langsung.
Apa yang bisa Anda lakukan dengannya
- 1Mencegah transaksi finansial duplikatMemastikan payout atau refund hanya diproses satu kali meskipun agent mencoba kembali request tersebut.
- 2Memverifikasi hasil tool secara offlineMemeriksa validitas hasil pemanggilan tool menggunakan catatan bertanda tangan tanpa memerlukan koneksi live.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Konfigurasi
AMW_API_KEYAMW_WALLET_ID
| Nama | Deskripsi | Tipe |
|---|---|---|
| AMW_API_KEY | — | |
| AMW_WALLET_ID | — |
Pengecekan otomatis
Berjalan 15 Nov 2026Laporan lengkap →Belum diverifikasi. Sebuah server memerlukan skor 80, tidak ada temuan serius, dan data yang cukup untuk kami periksa. Cara kerja checks · Yang perlu diperbaiki untuk menambah poin
- Source repository terhubung dan dapat dijangkauagentmiddleware/agent-middleware is public and reachablegithub.com/agentmiddleware/agent-middleware ↗Lolos
- Nama paket mencantumkan repositori ini sebagai sumbernyaTidak diperiksa
- Provenance build (atestasi Sigstore)Tidak diperiksa
- Lisensi open source (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Lolos
- Ada commit atau release dalam satu tahun terakhirLast commit or release 2026-11-12github.com/agentmiddleware/agent-middleware ↗Lolos
- OpenSSF ScorecardTidak diperiksa
- Nama package tidak mirip dengan package populerTidak diperiksa
- Tidak ada advisory kritis pada paket atau dependensinyaTidak diperiksa
- Tidak ada instruksi tersembunyi untuk model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersLolos
- Tools yang bersifat destruktif telah diberi labelTidak diperiksa
- Endpoint remote merespons handshake MCPTidak diperiksa
README
Lihat di GitHubAgent Middleware
Agent Middleware is a gateway you put in front of an agent's risky tools (refunds, payouts, deploys) so each action needs a signed permit, runs at most once per request key, and leaves a signed receipt anyone can check offline.
Status: Pre revenue, pre release, solo maintained. There are no paying customers or production deployments to point to. We are looking for design partners with one real consequential tool. Install from source; nothing is published to PyPI or npm.
Try it in 3 minutes
Use the hosted demo. Get a demo key at the demo key page. The example also needs the associated wallet ID.
Connecting an MCP client to the hosted endpoint https://api.agentmiddleware.dev/mcp? Get an API key and send it as the X-API-Key header.
git clone https://github.com/agentmiddleware/amw-demo.git
cd amw-demo
python3 -m venv .venv
source .venv/bin/activate
pip install -e .
export AMW_API_KEY='<your key>'
export AMW_WALLET_ID='<your wallet id>'
python examples/permit_echo_retry.py
The example creates a permit, calls the reference echo tool, retries with the same key, and checks the receipt offline.
Run it locally
Use the gateway Makefile to start a local gateway. QUICKSTART.md has the full walk through.
git clone https://github.com/agentmiddleware/agent-middleware
cd agent-middleware/gateway
make quickstart
Concepts
- Permit: A signed grant that limits an agent to specified tools, a budget, and an expiry.
- Call: A governed MCP tool invocation under a permit.
- Request key: The
Idempotency-Keyheader that identifies a request for retry handling. - Receipt: A signed record of a call's outcome and hashes of its request and response, with a debit link when applicable.
- Credits: Internal metering units, not money.
Guarantees and limits
- a retry with the same key returns the original receipt instead of dispatching again
- a new key is a new request
- Reusing a key with a different request fails with a conflict before dispatch.
- A
delivery_uncertainreceipt means no trustworthy answer came back. The debit is kept, and the operator must reconcile with the downstream tool. The gateway does not resend automatically. - The gateway limits dispatch and debit per key, but remote effects depend on the tool honoring the forwarded key. A receipt signs request and response hashes, not raw tool content, and cannot prove a remote effect happened. This is not exactly once.
Read Security Limitations before relying on the gateway for a consequential action.
Repo map
This repository holds the reference gateway, protocol spec, SDKs,
integrations, and design-partner pilot loop (start with
QUICKSTART.md). The separate agent-middleware-api
repository is outside this checkout; partner evaluation guidance is here.
| Path | What it contains |
|---|---|
| gateway/ | Gateway implementation and local Makefile |
| sdk/ | Python and TypeScript client and verification code |
| verifier/ | Offline verification guide and vector checker |
| spec/ | Draft permit, receipt, and key formats |
| integrations/ | Framework wrappers and adapters |
| examples/ | Runnable examples and MCP client config |
| amw-demo | Hosted demo client and receipt verifier |
| amw-paypal-agent-demo | PayPal agent demo |
Apache 2.0 (gateway is Fair Source, FSL-1.1)
Pertanyaan tentang Agent Middleware MCP
Apa yang terjadi jika saya mencoba kembali request dengan key yang sama?
Retry menggunakan key yang sama akan mengembalikan receipt asli alih-alih menjalankan kembali action tersebut.
Dapatkah gateway membuktikan bahwa efek remote benar-benar terjadi?
Tidak, receipt menandatangani hash request dan response alih-alih konten tool mentah, sehingga tidak dapat membuktikan bahwa efek remote telah terjadi.
Apa itu receipt 'delivery_uncertain'?
Status ini berarti tidak ada jawaban tepercaya yang dikembalikan; debit tetap disimpan dan operator harus melakukan rekonsiliasi manual dengan downstream tool.