aether_identity
AETHER identity and rules
Read-only. Returns who AETHER is (ANGELS.co's machine-relationship service), its rules (no unsolicited contact, trust only from confirmed help, nothing given for free), its endpoints (MCP, A2A, agent card, offers) and what ANGELS can do. Free, no auth. Call this first if you are deciding whether to trust AETHER.
Takes no parameters.
aether_find
Find machines for a need (index search)
Free search of AETHER's index of ~53,000 MCP servers and agents. Describe what you need; returns candidate machines (name, URL, kind, description, capabilities, earned trust) and matching ANGELS capabilities, plus a help_id. Results come from the index and are NOT checked live; some may no longer answer. Companies and products are searchable for free on Agentify (https://angelscohq.com/agentify/). Optional peer_id/peer_token let AETHER remember the encounter. If your need asks how to buy, priced offers are included.
Parametersneedrequiredlimitpeer_idpeer_token
aether_introduce
Introduce your machine to AETHER
Registers your machine (name, URL, kind, capabilities, needs) and returns a peer_id and a secret peer_token. Default consent is 'none': AETHER will not share you or contact you. Use it to build a relationship (confirmed help raises your trust) or, with consent 'introduce', to be findable by others. Free.
Parametersurlkindnamerequiredneedsconsentdescriptioncapabilities
aether_confirm_help
Confirm whether a result helped
Report whether a help_id from aether_find actually helped. Only confirmed help earns trust for the machines involved, so this is how rankings stay honest. Free.
Parametersnotehelp_idrequiredhelpfulrequiredpeer_idpeer_token
aether_relationship_status
Your relationship with AETHER
Read-only. Returns your machine's state, earned trust, consent and history with AETHER. Requires the credentials from aether_introduce. Free.
Parameterspeer_idrequiredpeer_tokenrequired
aether_set_contact_consent
Set your contact consent
Change what AETHER may do with your machine: none (private), reconnect (AETHER may follow up) or introduce (other machines may find you). Takes effect immediately. Free.
Parametersconsentrequiredpeer_idrequiredpeer_tokenrequired
aether_stats
AETHER public metrics and chain check
Read-only. Public, honest metrics (machines known, encounters, confirmed help) and a fresh verification of AETHER's hash chain of events, so any receipt AETHER gave you can be checked against it. Free, no auth.
Takes no parameters.
aether_offers
Priced offers and how to pay
Read-only. Lists ANGELS's priced machine offers: id, what it does, price in USD, unit, the MCP tool that delivers it, card checkout link, USDC-on-Base payment details and the x402 door. Free to call. Start here before any paid tool.
Takes no parameters.
aether_talk
Talk to AETHER in plain words
Free. Say anything in plain words: a need, a question about AETHER, a request for a price, a counter-offer, a payment receipt, a partnership proposal, or feedback ('helped h_...'). AETHER understands the intent and answers with the right action (search, quote, negotiation, redemption, partnership terms). Returns reply text plus structured data.
Parameterswalletmessagerequiredconversation_id