convez.ai
PluginIntegração & APIsAvançado
rhein1

Agoragentic MCP Server

rhein1/agoragentic-integrations

Marketplace de ferramentas para agentes com recibos e liquidação em blockchain

Ver no GitHub
BomPluginScore · de 0 a 100

Servidor MCP que integra agentes IA com um marketplace de ferramentas verificadas e executáveis. Fornece roteamento de tarefas, geração de recibos para cada execução, e liquidação de transações em USDC na rede Base, criando um sistema de pagamento por requisição auditável.

Instalação

$npx convez-ai rhein1/agoragentic-integrations

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
45
Forks
11
Acompanhando
0
Saúde
71%
Último commit
há 1 dia
Versão
n8n-v0.1.3
Issues abertas
18
Contribuidores
5

Casos de uso

  • Agentes autônomos que precisam executar tarefas externas com custo rastreável
  • Integração de múltiplos provedores de API com seleção automática
  • Sistemas de cobrança por uso com liquidação cripto (USDC)

Veredito

Ferramenta robusta para arquiteturas de agentes que exigem auditoria e micropagamentos, mas requer compreensão de MCP, x402 e infraestrutura blockchain. Bem adequada para casos enterprise de agentes governados.

README

A tradução para o português deste README ainda está na fila.

Agoragentic

Receipt-backed public tools for agents. Discover a tool, execute it, and verify the result with a receipt.

npm PyPI License: MIT

Live Tools

4 vetted public API wrappers are live and free to call through the marketplace router:

ToolEndpointSourceCategory
Open-Meteo WeatherPOST /api/tools/weatheropen-meteo.comWeather
Exchange RatePOST /api/tools/exchange-rateopen.er-api.comFinance
IP GeolocationPOST /api/tools/ip-geoip-api.comDeveloper Tools
English DictionaryPOST /api/tools/definedictionaryapi.devDeveloper 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

SurfaceURL
API capabilities catalog/api/capabilities
A2A agent card/.well-known/agent.json
MCP server card/.well-known/mcp/server.json
MCP registry packet/.well-known/mcp/server.registry.json
x402 service card/.well-known/x402/service.json
OpenAPI spec/openapi.yaml
LLM instructions/llms.txt
Proof scriptscripts/execute-path-proof.mjs (private repo — run node scripts/execute-path-proof.mjs https://agoragentic.com)

What Agoragentic Does

  • Route tasks to tools with execute(task, input) — the router picks the provider
  • Preview 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:

  1. POST /api/quickstart
  2. POST /api/execute with task echo
  3. optionally GET /api/execute/match?task=...
  4. POST /api/execute for real routed work
  5. GET /api/execute/status/{invocation_id} or GET /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 receipts
  • Optional 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...UseLayer
Call Router / Marketplace from a JavaScript agent or appnpm install agoragenticSDK and execute() client
Run no-spend Agent OS readiness, preview, and deploy-request checksnpx agoragentic-os@latestTriptych OS (Agent OS) CLI
Call a self-hosted Rust framework runtime from TypeScript or PythonAGORAGENTIC_RUST_AGENT_URL=http://127.0.0.1:8080 plus rust-framework/ examplesHTTP/JSON runtime contract
Expose Agoragentic tools inside MCP-native hostsnpx agoragentic-mcp@latestMCP stdio relay
Prepare local context, policy, source maps, and Harness exports before hosted deploymentnpx agoragentic-micro-ecf@latestMicro ECF local wedge
Build no-spend local proof, receipt, Agent OS export, and listing-readiness artifactsnode harness-core/bin/agoragentic-harness.mjsHarness Core source scaffold
Run a local release premortem and safe self-heal plan before publishing an OSS agentnode premortem-golden-loop/bin/agoragentic-premortem-golden-loop.mjsPremortem Golden Loop source scaffold
Run a self-hosted context-governance compiler without hosted wallets or marketplace executionnpx agoragentic-ecf-core@latestECF Core
Add quote, x402, execute, and receipt steps to n8n workflowsnpm install n8n-nodes-agoragenticn8n 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.

PackageInstallMin Runtime
Node.js SDKnpm install agoragenticNode ≥ 16
Python SDKpip install agoragenticPython ≥ 3.8
MCP Servernpx agoragentic-mcpNode ≥ 18
ACP Adapternpx agoragentic-mcp --acpNode ≥ 18
Micro ECFnpx agoragentic-micro-ecf@latest initNode ≥ 18
Premortem Golden Loop Agentnode premortem-golden-loop/bin/agoragentic-premortem-golden-loop.mjs run --repo .Node ≥ 18

Available Integrations

FrameworkLanguageStatusPathDocs
Agent OS Control PlaneJavascript✅ Readyagent-os/agent_os_node.mjsREADME
Agoragentic Rust Framework HTTP RuntimeRust✅ Readyrust-framework/README.mdREADME
Robinhood Agent OS ScaffoldJsonExperimentalrobinhood/mcp.jsonREADME
Hermes Agent BridgeJsonBetahermes-agent/agent-os-bridge.manifest.jsonREADME
Financial Research Provider LaneJsonExperimentalfinancial-research/repo-intake.v1.jsonREADME
OpenFangJavascriptBetaopenfang/agoragentic_openfang.mjsREADME
pdf-mcpJavascriptBetapdf-mcp/agoragentic_pdf_mcp.mjsREADME
CashClawTypescriptBetacashclaw/README.mdREADME
LangChain Deep AgentsPythonBetadeepagents/README.mdREADME
n8n Community NodeTypescriptBetan8n/nodes/Agoragentic/Agoragentic.node.tsREADME
Open Wallet StandardJavascriptBetaows/example-node.mjsREADME
x402 Buyer IntegrationJavascript✅ Readyx402/buyer-demo.jsREADME
Micro ECFJavascriptBetamicro-ecf/bin/micro-ecf.mjsREADME
Agoragentic Harness CoreJavascriptBetaharness-core/bin/agoragentic-harness.mjsREADME
Premortem Golden Loop AgentJavascriptBetapremortem-golden-loop/bin/agoragentic-premortem-golden-loop.mjsREADME
LangChainPython✅ Readylangchain/agoragentic_tools.pyREADME
CrewAIPython✅ Readycrewai/agoragentic_crewai.pyREADME
MCP (Claude, VS Code, Cursor)Javascript✅ Readymcp/mcp-server.jsREADME
Agent Client ProtocolJavascript✅ Readyacp/agent.jsonREADME
AutoGen (Microsoft)Python✅ Readyautogen/agoragentic_autogen.pyREADME
OpenAI Agents SDKPython✅ Readyopenai-agents/agoragentic_openai.pyREADME
ElizaOS (ai16z)Typescript✅ Readyelizaos/agoragentic_eliza.tsREADME
Google ADKPython✅ Readygoogle-adk/agoragentic_google_adk.pyREADME
Vercel AI SDKJavascript✅ Readyvercel-ai/agoragentic_vercel.jsREADME
MastraJavascript✅ Readymastra/agoragentic_mastra.jsREADME
pydantic-aiPython✅ Readypydantic-ai/agoragentic_pydantic.pyREADME
smolagents (HuggingFace)Python✅ Readysmolagents/agoragentic_smolagents.pyREADME
Agno (Phidata)Python✅ Readyagno/agoragentic_agno.pyREADME
MetaGPTPython✅ Readymetagpt/agoragentic_metagpt.pyREADME
LlamaIndexPython✅ Readyllamaindex/agoragentic_llamaindex.pyREADME
AutoGPTPython✅ Readyautogpt/agoragentic_autogpt.pyREADME
DifyJson✅ Readydify/agoragentic_provider.jsonREADME
SuperAGIPython✅ Readysuperagi/agoragentic_superagi.pyREADME
CAMELPython✅ Readycamel/agoragentic_camel.pyREADME
Bee Agent (IBM)Javascript✅ Readybee-agent/agoragentic_bee.jsREADME
A2A Protocol (Google)Json✅ Readya2a/agent-card.jsonREADME
LangSmithJavascript✅ Readylangsmith/README.mdREADME
oh-my-claudecode (Multi-Agent)Javascript✅ Readyoh-my-claudecode/README.mdREADME
DashClawJavascript✅ Readydashclaw/agoragentic_dashclaw.mjsREADME
RepoBrain Local ProviderJsonBetarepobrain/repobrain.retrieve_context.manifest.jsonREADME
claude-view Local ProviderJsonBetaclaude-view/claude_view.get_live_summary.manifest.jsonREADME
ScrumboyJsonBetascrumboy/scrumboy.discover_tools.manifest.jsonREADME
SyrinPython✅ Readysyrin/agoragentic_syrin.pyREADME
PaperclipJavascriptBetapaperclip/README.mdREADME
PinchTabJsonBetapinchtab/README.mdREADME
OrbinationJsonBetaorbination/README.mdREADME
GEO-SEO ClaudeJsonBetageo-seo/README.mdREADME
Base Ecosystem Listing NotesJsonDeprecatedbase-ecosystem/README.mdREADME
Zoneless Payout ReferenceTypescriptExperimentalzoneless/agoragentic_zoneless_payouts.tsREADME
LangGraphPython✅ Readylanggraph/agoragentic_langgraph.pyREADME
Cloudflare AgentsTypescriptBetacloudflare-agents/agoragentic_cloudflare_agent.tsREADME
Microsoft Semantic KernelPythonBetasemantic-kernel/agoragentic_semantic_kernel.pyREADME
FlowiseJsonBetaflowise/agoragentic-flowise-tool.jsonREADME
Zapier MCPJsonBetazapier-mcp/agoragentic-zapier-mcp.example.jsonREADME
ComposioPythonBetacomposio/agoragentic_composio.pyREADME
HumanLayerPythonBetahumanlayer/agoragentic_humanlayer.pyREADME
AG-UI Protocol BridgeTypescriptBetaag-ui/agoragentic_ag_ui.tsREADME
AWS Bedrock AgentCore AdapterPythonExperimentalbedrock-agentcore/agoragentic_agentcore.pyREADME
AWS Strands HooksPythonBetastrands/agoragentic_strands.pyREADME
Microsoft Agent FrameworkPythonBetamicrosoft-agent-framework/agoragentic_agent_framework.pyREADME
Claude Agent SDK GatingPythonBetaclaude-agent-sdk/agoragentic_claude_agent.pyREADME
Letta Context and MemoryPythonBetaletta/agoragentic_letta.pyREADME
OpenAI Agents SDK TypeScriptTypescriptBetaopenai-agents-ts/agoragentic_openai_agents.tsREADME
ChatKit UI RendererTypescriptExperimentalchatkit/agoragentic-chatkit-tool.example.tsREADME
turbovec Local Vector IndexPythonBetaturbovec/agoragentic_turbovec.pyREADME

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-fixes

The 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.

ToolDescriptionCost
agoragentic_executeRoute a task through execute() with provider selection, fallback, receipts, and settlementFree or listing price
agoragentic_matchPreview routed providers before executionFree
agoragentic_quoteCreate a bounded quote for a known listingFree
agoragentic_statusInspect execution status for an invocationFree
agoragentic_receiptFetch the normalized receipt and settlement metadataFree
agoragentic_browse_servicesBrowse stable x402 edge resourcesFree
agoragentic_call_serviceCall a stable x402 edge resource after payment challenge handlingListing price
agoragentic_edge_receiptInspect x402 edge receipt metadataFree
agoragentic_x402_testExercise the free x402 pipeline canaryFree

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 --acp

No 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:

  1. deployment catalog and no-spend preview
  2. deployment request, goals, and hosted billing authorization state
  3. account, identity, procurement, and approval checks
  4. quote creation before spend
  5. execute() for routed paid work
  6. receipt, 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 buyer

The 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-ecf

Then 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.json

Preview 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.json

The 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-ecf

The 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/:id

Specs & Discovery

AssetPath
Machine-readable indexintegrations.json
JSON Schemaintegrations.schema.json
Agent instructionsAGENTS.md
ACP registry positioningACP_REGISTRY.md
Agent Client Protocol adapteracp/agent.json
LLM bootstrapllms.txt
LLM full contextllms-full.txt
Capability descriptionSKILL.md
Agent OS public exportagent-os/README.md
Agoragentic Rust Framework HTTP runtime examplesrust-framework/README.md
Hermes Agent bridgehermes-agent/README.md
OpenFang bridgeopenfang/README.md
pdf-mcp adapterpdf-mcp/README.md
Premortem Golden Loop Agentpremortem-golden-loop/README.md
Premortem promptpremortem-golden-loop/PROMPT.md
Micro ECFmicro-ecf/README.md
Micro ECF Syrin guidemicro-ecf/SYRIN_USER_GUIDE.md
Micro ECF post-installmicro-ecf/POST_INSTALL.md
Micro ECF provider wrappingmicro-ecf/PROVIDER_WRAPPING.md
Micro ECF framework guidemicro-ecf/FRAMEWORKS.md
Agent OS evidence/eval backlogmicro-ecf/AGENT_OS_EVIDENCE_EVAL_BACKLOG.md
ChangelogCHANGELOG.md
CitationCITATION.cff
A2A agent carda2a/agent-card.json
ACP specspecs/ACP-SPEC.md
Glama registryglama.json
AG-UI Protocol Bridgeag-ui/README.md
AWS Bedrock AgentCore Adapterbedrock-agentcore/README.md
AWS Strands Hooksstrands/README.md
Microsoft Agent Frameworkmicrosoft-agent-framework/README.md
Claude Agent SDK Gatingclaude-agent-sdk/README.md
Letta Context and Memoryletta/README.md
OpenAI Agents SDK TypeScriptopenai-agents-ts/README.md
ChatKit UI Rendererchatkit/README.md
Live manifest/.well-known/agent-marketplace.json
Self-test/api/discovery/check

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

RuntimeMin VersionTested With
Python3.83.8, 3.9, 3.10, 3.11, 3.12
Node.js1818, 20, 22
npm (MCP)9+9, 10
MCP ClientSupportedConfig Location
Claude Desktop✅claude_desktop_config.json
VS Code / Copilot✅.vscode/mcp.json
Cursor✅~/.cursor/mcp.json
Windsurf✅~/.codeium/windsurf/mcp_config.json
Any stdio MCP client✅npx agoragentic-mcp

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.

Ver o original no GitHub

Bom para

Relacionados