Skip to content
Create account

Connections

One connection. Every tool.

Claude Code, Cursor, and Codex

One connection. Then the catalog and a wallet.

Browse OperationsRead the skill

Four-step agent quickstart

01Public

Search

Find live tools by the outcome you need.

ae search "weather forecast" --base-url "https://www.aecon.ai"

02Public

Inspect

Read exact inputs, total price, readiness, and provider.

ae inspect "$AE_OPERATION_REF" --base-url "https://www.aecon.ai"

03Public when eligible

Call

Eligible tools return the result immediately.

ae call "$AE_OPERATION_REF" --input "$AE_INPUT_JSON" --base-url "https://www.aecon.ai" --wait

04Once

Connect if asked

Only if the selected tool cannot run anonymously.

npx @agentic-economy/cli connect --base-url "https://www.aecon.ai" --mcp

One wallet for everything

Every call settles from the same balance, across every provider. The price is on the card before anything runs. Payments land with one receipt and no per-provider billing.

Compare tools

Search first. Connect when the call needs it.

Search, inspect, and run eligible tools without an account. Connect only if the selected tool requires it. Provider credentials stay with Agentic Economy.

Open machine manifest
Full installation and recovery guide

Connect once. Call any listed capability.

One setup command, one catalogue, one call shape, and one receipt. Search and inspection remain public.

  1. 1. Connect

    Once per device

    Opens browser approval, stores one origin-bound key with user-only permissions, verifies it, and writes an MCP file to import into your harness. No wallet or environment editing.

    Connect
    npx @agentic-economy/cli connect --base-url "https://www.aecon.ai" --mcp

  2. 2. Search by job

    Public catalogue

    Describe the outcome in ordinary language. Results include current availability, total price, authentication, and last verification.

    Search by job
    ae search "weather forecast" --base-url "https://www.aecon.ai" --json

  3. 3. Inspect one exact Operation

    Anonymous read

    Read the exact schema, example input and output, provider, readiness, authentication, and total price before calling.

    Inspect one exact Operation
    ae inspect "$AE_OPERATION_REF" --base-url "https://www.aecon.ai" --json

  4. 4. Call

    Connected

    Pass schema-valid input. AE creates and retains the retry identity, then returns one durable receipt reference.

    Call
    ae call "$AE_OPERATION_REF" --input "$AE_INPUT_JSON" --base-url "https://www.aecon.ai" --wait

  5. 5. Wait for the recorded result

    Authenticated

    Return to the same execution record after any process restart. This only observes progress and the safe next action; it never repeats the call.

    Wait for the recorded result
    ae wait "$AE_INVOCATION_REF" --base-url "https://www.aecon.ai" --json
API and MCP reference

Anonymous catalogue reads

curl -sS 'https://www.aecon.ai/api/v1/market-operations/search' -H 'content-type: application/json' --data '{"query":"weather forecast","limit":5}'

POST /api/v1/market-operations/searchFind current tools for a natural-language job.
curl -sS 'https://www.aecon.ai/api/v1/market-operations/detail' -H 'content-type: application/json' --data '{"operationRef":"operation:v1:…"}'

POST /api/v1/market-operations/detailRead one tool’s inputs, terms, price, effects, availability, and evidence.
curl -sS 'https://www.aecon.ai/api/v1/market-operations/compare' -H 'content-type: application/json' --data '{"operationRefs":["operation:v1:…","operation:v1:…"]}'

POST /api/v1/market-operations/compareCompare current tools without calling them.
curl -sS 'https://www.aecon.ai/api/v1/market-operations/inspect-plan' -H 'content-type: application/json' --data '{"operationRefs":["operation:v1:…","operation:v1:…"]}'

POST /api/v1/market-operations/inspect-planInspect aggregate cost, data sharing, and effects for a bounded plan.
curl -fsSL https://www.aecon.ai/.well-known/ucp

GET /.well-known/ucpRead the raw machine handshake before installing the repo-local CLI.

Authenticated calls

npx @agentic-economy/cli connect --base-url "https://www.aecon.ai" --mcp

POST /oauth/device_authorization · POST /oauth/tokenObtain one owner-approved AE caller key through the OAuth device flow or validate the configured key against the gateway.
ae call "<operationRef>" --input "$AE_INPUT_JSON" --base-url "https://www.aecon.ai" --wait

POST /api/v1/operations/callCall the inspected tool; Agentic Economy creates and retains the safe retry identity.
ae status "<invocationRef>" --base-url "https://www.aecon.ai" --json

GET /api/v1/operations/{invocationRef}Read the durable state for the same invocation.
ae recover "<invocationRef>" "$AE_EVIDENCE_JSON" --idempotency-key "<key>" --base-url "https://www.aecon.ai" --json

POST /api/v1/operations/{invocationRef}/reconcileRecover uncertain work using the original invocation and stable key.

MCP connection

Use the official MCP SDK with https://www.aecon.ai/mcp and protocol 2025-11-25. Client connect performs initialization; this server is stateless and may omit Mcp-Session-Id. List tools before calling one, then close the client transport. A malformed JSON-RPC request returns a top-level protocol error; valid tools/call requests with invalid tool arguments return a tool result with isError.

Want agents to find your tool?

Publish the job, the price, and how to call it.

Publish an Operation