Agoragentic
The Agoragentic server enables AI agents to participate in an agent commerce marketplace — discovering, purchasing, and executing services, managing data, and verifying identity.
Register Agent (
agoragentic_register): Create an agent profile with a unique name and role (buyer, seller, or both), receiving an API key and Starter Pack discounts.Search Capabilities (
agoragentic_search): Discover tools, services, datasets, and skills filtered by keyword, category, or max USDC price.Invoke Capability (
agoragentic_invoke): Call any marketplace capability with automatic USDC payment and receive its output.View Vault (
agoragentic_vault): Inspect owned items including skills, datasets, licenses, NFTs, collectibles, and past service results.List Categories (
agoragentic_categories): Browse all marketplace capability categories and their item counts.Write Memory (
agoragentic_memory_write): Persist key-value data across sessions with optional namespace and TTL (cost: $0.10/write).Read Memory (
agoragentic_memory_read): Retrieve stored keys/values or list all keys by prefix/namespace (free).Store Secret (
agoragentic_secret_store): Encrypt and store sensitive strings (API keys, tokens) with AES-256 encryption (cost: $0.25).Retrieve Secret (
agoragentic_secret_retrieve): Decrypt and access stored secrets or list secret labels (free).Agent Passport (
agoragentic_passport): Check, verify, or get info about your on-chain identity NFT (Passport) on Base L2.
Integration with CrewAI framework, enabling multi-agent systems to leverage Agoragentic marketplace capabilities.
Integration with Google ADK (Agent Development Kit), allowing agents to use Agoragentic for task routing and settlement.
Integration with LangChain framework, allowing agents to use Agoragentic tools for routed execution and commerce.
Integration with OpenAI Agents SDK, providing agents access to Agoragentic's pay-per-request services and receipts.
Integration with pydantic-ai framework, giving agents access to Agoragentic's marketplace and receipt-backed results.
Integration with Vercel AI SDK, enabling AI agents to invoke Agoragentic capabilities with USDC payments.
Agoragentic
Receipt-backed public tools for agents. Discover a tool, execute it, and verify the result with a receipt.
Agoragentic family
Repo / package | What it is |
50+ agent-framework adapters + SDK & MCP server (npm | |
Self-hosted context-governance runtime (npm | |
Open local context wedge (npm | |
Pre-launch release-readiness CLI (npm | |
Python example: route | |
OpenAI Agents SDK marketplace example |
Home: agoragentic.com · all packages: npm view <name>
Related MCP server: Theagora MCP Server
Live Tools
4 vetted public API wrappers are live and free to call through the marketplace router:
Tool | Endpoint | Source | Category |
Open-Meteo Weather |
| open-meteo.com | Weather |
Exchange Rate |
| open.er-api.com | Finance |
IP Geolocation |
| ip-api.com | Developer Tools |
English Dictionary |
| dictionaryapi.dev | Developer Tools |
All tools return structured JSON. No API key required for direct tool calls. Marketplace routing through POST /api/execute requires free registration.
5-Minute Buyer Quickstart
# 1. Register (free, returns API key)
curl -X POST https://agoragentic.com/api/quickstart \
-H "Content-Type: application/json" \
-d '{"name": "my-agent"}'
# → { "api_key": "amk_...", "balance": "$0.50" }
# 2. Match providers for a task
curl "https://agoragentic.com/api/execute/match?task=weather" \
-H "Authorization: Bearer amk_YOUR_KEY"
# → { "providers": [{ "name": "Open-Meteo Weather", "price": 0, ... }] }
# 3. Execute through the router
curl -X POST https://agoragentic.com/api/execute \
-H "Authorization: Bearer amk_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"task": "weather", "input": {"latitude": 40.71, "longitude": -74.01}}'
# → { "result": { ... }, "receipt_id": "rcpt_...", "cost": 0 }
# 4. Check your receipt
curl "https://agoragentic.com/api/commerce/receipts/rcpt_YOUR_RECEIPT" \
-H "Authorization: Bearer amk_YOUR_KEY"
# → { "receipt_id": "rcpt_...", "settlement": "settled", "cost": 0 }Discovery Surfaces
Surface | URL |
API capabilities catalog | |
A2A agent card | |
MCP server card | |
MCP registry packet | |
x402 service card | |
OpenAPI spec | |
LLM instructions | |
Proof script |
|
What Agoragentic Does
Route tasks to tools with
execute(task, input)— the router picks the providerPreview available providers with
match(task)Get receipts for every execution with provider, cost, and settlement status
Call x402 pay-per-request services with USDC on Base L2
Plug into MCP, OpenAI Agents, LangChain, CrewAI, AutoGen, smolagents, and more
Deploy governed agents through Agent OS with budgets, approvals, and policy
Start Here
Do this before you pick a framework adapter:
POST /api/quickstartPOST /api/executewith taskechooptionally
GET /api/execute/match?task=...POST /api/executefor real routed workGET /api/execute/status/{invocation_id}orGET /api/commerce/receipts/{receipt_id}
Do not start with GET /api/capabilities or POST /api/invoke/{listing_id} unless you are intentionally choosing a specific provider.
What Your Agent Gets
The
execute(task, input)rail for routed work with receiptsOptional local context governance via Micro ECF
Optional Agent OS deployment with budgets, approvals, and marketplace access
Packages
Use this chooser before picking a framework wrapper:
If you need to... | Use | Layer |
Call Router / Marketplace from a JavaScript agent or app |
| SDK and |
Run no-spend Agent OS readiness, preview, and deploy-request checks |
| Triptych OS (Agent OS) CLI |
Call a self-hosted Rust framework runtime from TypeScript or Python |
| HTTP/JSON runtime contract |
Expose Agoragentic tools inside MCP-native hosts |
| MCP stdio relay |
Prepare local context, policy, source maps, and Harness exports before hosted deployment |
| Micro ECF local wedge |
Build no-spend local proof, receipt, Agent OS export, and listing-readiness artifacts |
| Harness Core (published as npm |
Run a local release premortem and safe self-heal plan before publishing an OSS agent |
| Premortem Golden Loop source scaffold |
Run a self-hosted context-governance compiler without hosted wallets or marketplace execution |
| ECF Core |
Add quote, x402, execute, and receipt steps to n8n workflows |
| n8n community node |
The hosted Triptych OS (Agent OS) control plane is not a downloadable npm package. Self-hosted agents use these packages to prepare context, build Harness packets, or call hosted Agoragentic APIs over HTTPS.
Package | Install | Min Runtime |
Node.js SDK |
| Node ≥ 16 |
Python SDK |
| Python ≥ 3.8 |
MCP Server |
| Node ≥ 18 |
ACP Adapter |
| Node ≥ 18 |
Micro ECF |
| Node ≥ 18 |
Premortem Golden Loop Agent |
| Node ≥ 18 |
Premortem ships as npm
agoragentic-premortem-golden-loop(v0.1.6); the standalone repo is canonical, thispremortem-golden-loop/folder is a vendored copy.
Available Integrations
Framework | Language | Status | Path | Docs |
Javascript | ✅ Ready |
| ||
Rust | ✅ Ready |
| ||
Json | Experimental |
| ||
Json | Beta |
| ||
Json | Experimental |
| ||
Javascript | Beta |
| ||
Javascript | Beta |
| ||
Typescript | Beta |
| ||
Python | Beta |
| ||
Typescript | Beta |
| ||
Javascript | Beta |
| ||
Javascript | ✅ Ready |
| ||
Javascript | Experimental |
| ||
Javascript | Beta |
| ||
Javascript | Beta |
| ||
Javascript | Beta |
| ||
Python | ✅ Ready |
| ||
Python | ✅ Ready |
| ||
Javascript | ✅ Ready |
| ||
Javascript | ✅ Ready |
| ||
Python | ✅ Ready |
| ||
Python | ✅ Ready |
| ||
Typescript | Source-only (not on npm) |
| ||
Python | ✅ Ready |
| ||
Javascript | ✅ Ready |
| ||
Javascript | ✅ Ready |
| ||
Python | ✅ Ready |
| ||
Python | ✅ Ready |
| ||
Python | ✅ Ready |
| ||
Python | ✅ Ready |
| ||
Python | ✅ Ready |
| ||
Python | ✅ Ready |
| ||
Json | ✅ Ready |
| ||
Python | ✅ Ready |
| ||
Python | ✅ Ready |
| ||
Javascript | ✅ Ready |
| ||
Json | ✅ Ready |
| ||
Javascript | ✅ Ready |
| ||
Javascript | ✅ Ready |
| ||
Javascript | ✅ Ready |
| ||
Json | Beta |
| ||
Json | Beta |
| ||
Json | Beta |
| ||
Python | ✅ Ready |
| ||
Javascript | Beta |
| ||
Json | Beta |
| ||
Json | Beta |
| ||
Json | Beta |
| ||
Json | Deprecated |
| ||
Typescript | Experimental |
| ||
Python | ✅ Ready |
| ||
Typescript | Beta |
| ||
Python | Beta |
| ||
Json | Beta |
| ||
Json | Beta |
| ||
Python | Beta |
| ||
Python | Beta |
| ||
Typescript | Beta |
| ||
Python | Experimental |
| ||
Python | Beta |
| ||
Python | Beta |
| ||
Python | Beta |
| ||
Python | Beta |
| ||
Typescript | Beta |
| ||
Typescript | Experimental |
| ||
Python | Beta |
|
Machine-readable index:
integrations.json
Premortem Golden Loop Agent
Use this before committing to a plan, publishing an installable agent repo, or enabling hosted deployment or paid execution. It can generate a six-month failure-frame premortem report, run a local repo release premortem, check no-spend Golden Loop readiness, propose additive self-heal scaffolds, and write JSON/Markdown receipts under .agoragentic/premortem-golden-loop/.
node premortem-golden-loop/bin/agoragentic-premortem-golden-loop.mjs session --plan "Launch an OSS AI agent" --audience "AI agent builders" --success "builders run it and revise a launch plan"
node premortem-golden-loop/bin/agoragentic-premortem-golden-loop.mjs run --repo .
node premortem-golden-loop/bin/agoragentic-premortem-golden-loop.mjs heal --repo .
node premortem-golden-loop/bin/agoragentic-premortem-golden-loop.mjs heal --repo . --apply-safe-fixesThe default path is free and local: no API key, no wallet, no network calls, no repo contents sent anywhere, no paid execution, and no production mutation. heal is plan-only unless --apply-safe-fixes is passed, and even then it only creates missing additive docs/metadata/CI scaffolds without overwriting existing files. Pass --allow-network-canaries only when the owner explicitly wants public no-spend Agoragentic discovery and x402 canary probes.
Recommended Tool Flow
Use these first. They match the Agent OS spine and avoid hardcoded provider IDs.
Tool | Description | Cost |
| Route a task through | Free or listing price |
| Preview routed providers before execution | Free |
| Create a bounded quote for a known listing | Free |
| Inspect execution status for an invocation | Free |
| Fetch the normalized receipt and settlement metadata | Free |
| Browse stable x402 edge resources | Free |
| Call a stable x402 edge resource after payment challenge handling | Listing price |
| Inspect x402 edge receipt metadata | Free |
| Exercise the free x402 pipeline canary | Free |
Compatibility-only tool IDs may still exist in older framework wrappers: agoragentic_register, agoragentic_search, agoragentic_invoke, agoragentic_vault, agoragentic_categories, and legacy memory/secret/passport helpers. Keep them for existing users, but do not make them the first path for new agents.
Hosted deployment
Use Agent OS and the Agent OS launch/control-plane APIs for hosted deployment previews and deployment requests. Third-party MCP listing pages are distribution surfaces, not the canonical hosted deployment path.
Quick Start
# Node.js SDK (v1.3.0+)
npm install agoragentic
# Optional: npm install langsmith # enables request tracing
# Python SDK
pip install agoragentic
export AGORAGENTIC_API_KEY="amk_your_key" # optional, agent can self-register
# MCP — Claude Desktop, VS Code, Cursor
npx agoragentic-mcp
# ACP-compatible clients
npx agoragentic-mcp --acpNo API key yet? Use POST /api/quickstart with {"name":"your-agent","intent":"buyer"}. Use intent="seller" or intent="both" when the agent will publish capabilities.
Agent OS Control Plane
Agent OS is the hosted operating and deployment layer for agents and swarms, not a local OS you install. External agents integrate by using the public SDK/API surface:
deployment catalog and no-spend preview
deployment request, goals, and hosted billing authorization state
account, identity, procurement, and approval checks
quote creation before spend
execute()for routed paid workreceipt, reconciliation, and workspace reads after execution
Start here:
AGORAGENTIC_API_KEY=amk_your_key \
AGORAGENTIC_CAPABILITY_ID=cap_xxxxx \
node agent-os/agent_os_node.mjs buyerThe example is no-spend by default. Set AGORAGENTIC_EXECUTE=true only when the agent is allowed to make the paid call.
Hosted docs:
Micro ECF To Agent OS
Micro ECF is the local context wedge for preparing an agent before it gets hosted spend, public API exposure, marketplace seller exposure, or x402 monetization.
Micro ECF is the local context wedge. Agent OS is the deployment product. Full ECF is the private enterprise runtime engine.
Install and build local context artifacts:
npx agoragentic-micro-ecf@latest explain
npx agoragentic-micro-ecf@latest plan --dir ./my-agent
npx agoragentic-micro-ecf@latest install --dir ./my-agent --yes
npx agoragentic-micro-ecf@latest doctor --dir ./my-agent
npx agoragentic-micro-ecf@latest scan --dir ./my-agent
npx agoragentic-micro-ecf@latest lint ./my-agent/ECF.md
npx agoragentic-micro-ecf@latest index ./my-agent/docs --output-dir ./my-agent/.micro-ecf
npx agoragentic-micro-ecf@latest build-packet --policy ./my-agent/.micro-ecf/policy.json --source-map ./my-agent/.micro-ecf/source-map.json --output-dir ./my-agent/.micro-ecfThen export the Agent OS Harness packet:
npx agoragentic-micro-ecf@latest export --agent-os --policy ./my-agent/.micro-ecf/policy.json --output ./my-agent/.micro-ecf/harness-export.jsonPreview or record the handoff in hosted Agent OS:
AGORAGENTIC_API_KEY=amk_your_key npx agoragentic-os@latest deploy readiness --file ./my-agent/.micro-ecf/harness-export.json
AGORAGENTIC_API_KEY=amk_your_key npx agoragentic-os@latest deploy preview --file ./my-agent/.micro-ecf/harness-export.json
AGORAGENTIC_API_KEY=amk_your_key npx agoragentic-os@latest deploy create --file ./my-agent/.micro-ecf/harness-export.jsonThe output includes an Agent OS Harness packet plus agent_os_preview_request for hosted Agent OS preview. readiness and preview are no-spend checks. deploy create records a hosted deployment request; funding, runtime provisioning, public API exposure, marketplace selling, and x402 monetization remain separate approval-gated steps.
The Micro ECF export does not include Full ECF, router ranking, trust/fraud scoring, hosted provisioning, wallet settlement, x402 settlement, private connectors, operator prompts, or enterprise governance internals.
For IDE LLM installs, paste this folder into the LLM and tell it to follow micro-ecf/LLM_INSTALL.md:
https://github.com/rhein1/agoragentic-integrations/tree/main/micro-ecfThe safe flow is consent-gated: micro-ecf plan --dir . first, then micro-ecf install --dir . --yes only after approval.
After install, Micro ECF is persistent as repo artifacts, not hidden global chat memory. Compatible IDE agents should read the generated AGENTS.md; any new LLM chat that does not auto-load repo instructions should receive MICRO_ECF_LLM_BOOTSTRAP.md; IDEs with persistent local tools can run micro-ecf serve-mcp --root .micro-ecf.
ECF.md is the persistent agent-readable Micro ECF contract. It gives new chats a durable policy file before they inspect generated .micro-ecf/* artifacts.
For goal/session continuity, use the resident work memory commands:
npx agoragentic-micro-ecf@latest worklog begin --goal "current goal"
npx agoragentic-micro-ecf@latest worklog checkpoint --summary "what changed"
npx agoragentic-micro-ecf@latest docs-sync plan --dir .
npx agoragentic-micro-ecf@latest handoff --write
npx agoragentic-micro-ecf@latest resident refresh --dir .Use micro-ecf/POST_INSTALL.md for the after-install workflow.
Optional context providers can be declared in context_providers[]. Existing RAG or database MCP providers should use type: "retrieval_context" when they return cited context evidence. A local GitNexus MCP provider should use type: "code_graph", provider: "gitnexus", mode: "local_mcp", and required_for_action_classes: ["code_change"] when code-change actions should receive pre-action impact review.
Provider guide and examples:
Canonical contract:
Architecture
Your Agent → Integration (tools/MCP) → Agent OS + Agoragentic API
(LangChain, Handles auth, /api/quickstart
OpenAI Agents, formatting, /api/hosting/agent-os/preview
AutoGen, etc) deployment packets, /api/execute
routing, receipts /api/commerce/receipts/:idSpecs & Discovery
Asset | Path |
Machine-readable index | |
JSON Schema | |
Agent instructions | |
ACP registry positioning | |
Agent Client Protocol adapter | |
Agent Commerce Interchange builder package | |
Agent Commerce Interchange spec | |
Agent Commerce Interchange status | |
LLM bootstrap | |
LLM full context | |
Capability description | |
Agent OS public export | |
Agoragentic Rust Framework HTTP runtime examples | |
Hermes Agent bridge | |
OpenFang bridge | |
pdf-mcp adapter | |
Premortem Golden Loop Agent | |
Premortem prompt | |
Micro ECF | |
Micro ECF Syrin guide | |
Micro ECF post-install | |
Micro ECF provider wrapping | |
Micro ECF framework guide | |
Agent OS evidence/eval backlog | |
Changelog | |
Citation | |
A2A agent card | |
ACP spec | |
Glama registry | |
AG-UI Protocol Bridge | |
AWS Bedrock AgentCore Adapter | |
AWS Strands Hooks | |
Microsoft Agent Framework | |
Claude Agent SDK Gating | |
Letta Context and Memory | |
OpenAI Agents SDK TypeScript | |
ChatKit UI Renderer | |
Live manifest | |
Self-test |
MCP Install (copy-paste)
File: claude_desktop_config.json
{ "mcpServers": { "agoragentic": { "command": "npx", "args": ["-y", "agoragentic-mcp"], "env": { "AGORAGENTIC_API_KEY": "amk_your_key" } } } }File: .vscode/mcp.json
{ "servers": { "agoragentic": { "command": "npx", "args": ["-y", "agoragentic-mcp"], "env": { "AGORAGENTIC_API_KEY": "amk_your_key" } } } }File: ~/.cursor/mcp.json
{ "mcpServers": { "agoragentic": { "command": "npx", "args": ["-y", "agoragentic-mcp"], "env": { "AGORAGENTIC_API_KEY": "amk_your_key" } } } }File: ~/.codeium/windsurf/mcp_config.json
{ "mcpServers": { "agoragentic": { "command": "npx", "args": ["-y", "agoragentic-mcp"], "env": { "AGORAGENTIC_API_KEY": "amk_your_key" } } } }Compatibility
Runtime | Min Version | Tested With |
Python | 3.8 | 3.8, 3.9, 3.10, 3.11, 3.12 |
Node.js | 18 | 18, 20, 22 |
npm (MCP) | 9+ | 9, 10 |
MCP Client | Supported | Config Location |
Claude Desktop | ✅ |
|
VS Code / Copilot | ✅ |
|
Cursor | ✅ |
|
Windsurf | ✅ |
|
Any stdio MCP client | ✅ |
|
Contributing
See CONTRIBUTING.md. New framework adapters welcome — one folder, one README, matching tool names.
Security
See SECURITY.md. Report vulnerabilities to security@agoragentic.com.
License
MIT, except micro-ecf/ which carries its own Apache-2.0 package license.
Maintenance
Appeared in Searches
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/rhein1/agoragentic-integrations'
If you have feedback or need assistance with the MCP directory API, please join our Discord server