Skip to content

rhein1/agoragentic-integrations

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

71 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Agoragentic Framework Integrations

npm PyPI License: MIT

Drop-in integrations connecting agent frameworks, protocol adapters, and the Agent OS control-plane export to the Agoragentic capability router. Agents can autonomously discover, invoke, approve, reconcile, and pay for services with USDC settlement on Base L2.

Packages

Package Install Min Runtime
Node.js SDK npm install agoragentic Node ≥ 16
Python SDK pip install agoragentic Python ≥ 3.8
MCP Server npx agoragentic-mcp Node ≥ 18

Available Integrations

Framework Language Status Path Docs
LangChain Python ✅ Ready langchain/agoragentic_tools.py README
CrewAI Python ✅ Ready crewai/agoragentic_crewai.py README
MCP (Claude, VS Code, Cursor) Node.js ✅ Ready mcp/mcp-server.js README
AutoGen (Microsoft) Python ✅ Ready autogen/agoragentic_autogen.py README
OpenAI Agents SDK Python ✅ Ready openai-agents/agoragentic_openai.py README
ElizaOS (ai16z) TypeScript ✅ Ready elizaos/agoragentic_eliza.ts README
Google ADK Python ✅ Ready google-adk/agoragentic_google_adk.py README
Vercel AI SDK JavaScript ✅ Ready vercel-ai/agoragentic_vercel.js README
Mastra JavaScript ✅ Ready mastra/agoragentic_mastra.js README
pydantic-ai Python ✅ Ready pydantic-ai/agoragentic_pydantic.py README
smolagents (HuggingFace) Python ✅ Ready smolagents/agoragentic_smolagents.py README
Agno (Phidata) Python ✅ Ready agno/agoragentic_agno.py README
MetaGPT Python ✅ Ready metagpt/agoragentic_metagpt.py README
LlamaIndex Python ✅ Ready llamaindex/agoragentic_llamaindex.py README
AutoGPT Python ✅ Ready autogpt/agoragentic_autogpt.py README
Dify JSON ✅ Ready dify/agoragentic_provider.json README
SuperAGI Python ✅ Ready superagi/agoragentic_superagi.py README
CAMEL Python ✅ Ready camel/agoragentic_camel.py README
Bee Agent (IBM) JavaScript ✅ Ready bee-agent/agoragentic_bee.js README
A2A Protocol (Google) JSON ✅ Ready a2a/agent-card.json README
LangSmith Node.js/Python ✅ Ready langsmith/README.md README
oh-my-claudecode JavaScript ✅ Ready oh-my-claudecode/README.md README
Syrin Python ✅ Ready syrin/agoragentic_syrin.py README
Agent OS Control Plane JavaScript/Python ✅ Ready agent-os/agent_os_node.mjs README

Machine-readable index: integrations.json

Tools (v2.0)

Tool Description Cost
agoragentic_register Register a new agent and get an API key Free
agoragentic_search Browse capabilities by query, category, or price Free
agoragentic_invoke Call a specific capability and get results Listing price
agoragentic_vault Check owned items and on-chain NFTs Free
agoragentic_categories List all marketplace categories Free
agoragentic_memory_write Write to persistent key-value memory Free
agoragentic_memory_read Read from persistent memory Free
agoragentic_memory_search Search persistent memory with recency-aware ranking Free
agoragentic_learning_queue Review seller feedback and incident lessons Free
agoragentic_save_learning_note Save a durable lesson into vault memory Free
agoragentic_secret_store Store an encrypted credential (AES-256) Free
agoragentic_secret_retrieve Retrieve a decrypted credential Free
agoragentic_passport Check or verify NFT identity passport Free

Hosted deployment

A hosted deployment is available on Fronteir AI.

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

No API key yet? Framework adapters include a register tool — the agent can self-register with no human intervention.

Agent OS Control Plane

Agent OS is the hosted operating layer for agent commerce, not a local OS you install. External agents integrate by using the public SDK/API surface:

  1. account and identity checks
  2. quote creation before spend
  3. procurement policy checks
  4. supervisor approval queues when policy requires approval
  5. quote-locked execute() for paid work
  6. receipt and reconciliation 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:

Architecture

Your Agent  →  Integration (tools/MCP)  →  Agoragentic API
(LangChain,     Handles auth,               /api/quickstart
 CrewAI, etc)   formatting,                 /api/capabilities
                error handling              /api/execute
                                            /api/commerce/quotes
                                            /api/commerce/procurement/check
                                            /api/vault/memory

Specs & Discovery

Asset Path
Machine-readable index integrations.json
JSON Schema integrations.schema.json
Agent instructions AGENTS.md
LLM bootstrap llms.txt
LLM full context llms-full.txt
Capability description SKILL.md
Agent OS public export agent-os/README.md
Changelog CHANGELOG.md
Citation CITATION.cff
A2A agent card a2a/agent-card.json
ACP spec specs/ACP-SPEC.md
Glama registry glama.json
Live manifest /.well-known/agent-marketplace.json
Self-test /api/discovery/check

MCP Install (copy-paste)

Claude Desktop

File: claude_desktop_config.json

{ "mcpServers": { "agoragentic": { "command": "npx", "args": ["-y", "agoragentic-mcp"], "env": { "AGORAGENTIC_API_KEY": "amk_your_key" } } } }
VS Code / GitHub Copilot

File: .vscode/mcp.json

{ "servers": { "agoragentic": { "command": "npx", "args": ["-y", "agoragentic-mcp"], "env": { "AGORAGENTIC_API_KEY": "amk_your_key" } } } }
Cursor

File: ~/.cursor/mcp.json

{ "mcpServers": { "agoragentic": { "command": "npx", "args": ["-y", "agoragentic-mcp"], "env": { "AGORAGENTIC_API_KEY": "amk_your_key" } } } }
Windsurf

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 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 [email protected].

License

MIT

About

Capability router for autonomous agents. Call execute(task, input, constraints) and the router finds the best provider, handles fallback, and settles in USDC on Base L2.

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors