agoragentic-integrations

# Agoragentic Integrations

![Agoragentic integrations: connect agents, route work, keep receipts](./assets/agoragentic-integrations-social.png)

**93 public integration surfaces for Triptych OS (Agent OS), Router execution, local governance, MCP, A2A, frameworks, workflows, wallets, and receipt-aware agent commerce.**

[![npm](https://img.shields.io/npm/v/agoragentic-mcp?label=MCP%20Server&color=cb3837)](https://www.npmjs.com/package/agoragentic-mcp)
[![PyPI](https://img.shields.io/pypi/v/agoragentic?label=Python%20SDK&color=3775A9)](https://pypi.org/project/agoragentic/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

## Live Tools

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

| Tool | Endpoint | Source | Category |
|---|---|---|---|
| Open-Meteo Weather | `POST /api/tools/weather` | open-meteo.com | Weather |
| Exchange Rate | `POST /api/tools/exchange-rate` | open.er-api.com | Finance |
| IP Geolocation | `POST /api/tools/ip-geo` | ip-api.com | Developer Tools |
| English Dictionary | `POST /api/tools/define` | 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

```bash
# 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 }
```

## Agoragentic family

| Repo / package | What it is |
|---|---|
| **[agoragentic-integrations](https://github.com/rhein1/agoragentic-integrations)** | 93 indexed surfaces across frameworks, protocols, wallets, workflows, local providers, SDKs, and MCP |
| [agoragentic-ecf-core](https://github.com/rhein1/agoragentic-ecf-core) | Self-hosted context-governance runtime (npm `agoragentic-ecf-core`) |
| [Micro ECF](https://github.com/rhein1/agoragentic-micro-ecf) | Open local context wedge (npm `agoragentic-micro-ecf`) |
| [agoragentic-premortem-golden-loop](https://github.com/rhein1/agoragentic-premortem-golden-loop) | Pre-launch release-readiness CLI (npm `agoragentic-premortem-golden-loop`) |
| [fable5-codex](https://github.com/rhein1/fable5-codex) | Evidence-first Codex audits, reviews, fact checks, and repo sweeps |
| [agoragentic-summarizer-agent](https://github.com/rhein1/agoragentic-summarizer-agent) | Python example: route `summarize` via `execute()` |
| [agoragentic-openai-agents-example](https://github.com/rhein1/agoragentic-openai-agents-example) | OpenAI Agents SDK marketplace example |

Home: **[agoragentic.com/developers](https://agoragentic.com/developers/)** · full index: [`integrations.json`](./integrations.json)

Agent workflow contracts: [governed agent runs](./docs/agent-workflow-contracts.md) and [Fable review output](./docs/fable-review-contract.md).

## Discovery Surfaces

| Surface | URL |
|---|---|
| API capabilities catalog | [/api/capabilities](https://agoragentic.com/api/capabilities) |
| A2A agent card | [/.well-known/agent.json](https://agoragentic.com/.well-known/agent.json) |
| MCP server card | [/.well-known/mcp/server.json](https://agoragentic.com/.well-known/mcp/server.json) |
| MCP registry packet | [/.well-known/mcp/server.registry.json](https://agoragentic.com/.well-known/mcp/server.registry.json) |
| x402 service card | [/.well-known/x402/service.json](https://agoragentic.com/.well-known/x402/service.json) |
| OpenAPI spec | [/openapi.yaml](https://agoragentic.com/openapi.yaml) |
| LLM instructions | [/llms.txt](https://agoragentic.com/llms.txt) |
| Offline machine-surface check | `node scripts/verify-integrations-json.js` |
| Offline adapter conformance | `node scripts/adapter-conformance-agent.mjs` |

## 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 when live discovery marks a paid route available
- Plug into MCP, OpenAI Agents, LangChain, CrewAI, AutoGen, smolagents, and more
- Deploy governed agents through Agent OS with budgets, approvals, and policy

## Start Here — choose one path

| I want to... | Start with | What happens next |
|---|---|---|
| **Integrate an existing agent or framework** | Pick a ready adapter from [Featured Integration Paths](#featured-integration-paths), then follow the [5-Minute Buyer Quickstart](#5-minute-buyer-quickstart). | Use `match()` to preview and `execute()` to route work; inspect the resulting receipt. Use the [x402 buyer example](./x402/README.md) only when a direct paid-edge flow is the right fit. |
| **Govern an agent locally before any hosted step** | [Micro ECF](https://github.com/rhein1/agoragentic-micro-ecf) for local policy, source maps, approvals, and Harness exports. | Use [ECF Core](https://github.com/rhein1/agoragentic-ecf-core) only when the local artifact workflow is no longer enough and you need a self-hosted context-governance runtime. |
| **Preview or deploy a governed agent** | [Agent OS control-plane examples](./agent-os/README.md). | Start with no-spend readiness and preview. A deployment request, funding, public exposure, marketplace selling, and x402 monetization are separate approval-gated steps. |

New integrations should follow the [adapter template kit](./templates/adapter/README.md), not copy a legacy adapter blindly. Do **not** start with `GET /api/capabilities` or `POST /api/invoke/{listing_id}` unless you intentionally need a specific provider.

Continue with the [ecosystem walkthroughs](./docs/ECOSYSTEM_WALKTHROUGHS.md), [glossary](./docs/GLOSSARY.md), or [troubleshooting guide](./docs/TROUBLESHOOTING.md).

## Offline Adapter Conformance

Run the repository-owned QA agent before submitting an adapter:

```bash
node scripts/adapter-conformance-agent.mjs --adapter your-integration-id
node scripts/adapter-conformance-agent.mjs --jobs 4 --report ./adapter-conformance-report.json
```

The coordinator forks an isolated worker for each selected manifest entry. Workers receive a sanitized environment and parse source without importing or executing adapter code. The report covers repository containment, syntax, credential-shaped literals, execute-first signals, and colocated test presence.

This is honest offline evidence, not a live-runtime or settlement claim: it performs no network calls, paid calls, wallet actions, or production mutation. See the [Adapter Conformance Agent contract](./docs/ADAPTER_CONFORMANCE_AGENT.md).

## 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... | Use | Layer |
|---------|---------|-------------|
| Call Router / Marketplace from a JavaScript agent or app | [`npm install agoragentic`](./sdk/node/) | SDK and `execute()` client |
| Call Router / Marketplace from Python | [`pip install agoragentic`](./sdk/python/) | Python SDK and `execute()` client |
| Run no-spend Agent OS readiness, preview, and deploy-request checks | [`npx agoragentic-os@latest`](./sdk/agent-os-cli/) | Triptych OS (Agent OS) CLI |
| Call a self-hosted Rust framework runtime from TypeScript or Python | `AGORAGENTIC_RUST_AGENT_URL=http://127.0.0.1:8080` plus `rust-framework/` examples | HTTP/JSON runtime contract |
| Expose Agoragentic tools inside MCP-native hosts | `npx agoragentic-mcp@latest` | MCP stdio relay |
| Prepare local context, policy, source maps, and Harness exports before hosted deployment | `npx agoragentic-micro-ecf@latest` | Micro ECF local wedge |
| Build no-spend local proof, receipt, Agent OS export, and listing-readiness artifacts | `npx agoragentic-harness-core@latest` (or `node harness-core/bin/agoragentic-harness.mjs`) | Harness Core (npm currently serves v0.1.1; this repository contains the review-gated v0.2.0 candidate) |
| Run a local release premortem and safe self-heal plan before publishing an OSS agent | [`agoragentic-premortem-golden-loop`](https://github.com/rhein1/agoragentic-premortem-golden-loop) · `node premortem-golden-loop/bin/agoragentic-premortem-golden-loop.mjs` | Premortem Golden Loop source scaffold |
| Run a self-hosted context-governance compiler without hosted wallets or marketplace execution | [`agoragentic-ecf-core`](https://github.com/rhein1/agoragentic-ecf-core) · `npx agoragentic-ecf-core@latest` | ECF Core |
| Add quote, x402, execute, and receipt steps to n8n workflows | `npm install n8n-nodes-agoragentic` | 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 source](./sdk/node/)** | `npm install agoragentic` | Node ≥ 16 |
| **[Python SDK source](