directory.lookupModule 43Let a visiting agent from another organization find your published door, knock, and wait to be admitted to a room on your terms.
directory.lookup is the Gatehouse front door. A caller resolves what a domain publishes for agents and reads back its entries; directory.list adds doors, matters, lanes, treaties, policy and hostnames. Admission to any room happens behind the same door, never by exposing an internal endpoint.
Put admission in front of your MCP servers, repositories, SaaS tools and cloud accounts. Every agent gets a lease or a reason – and you keep the lever to stop any of them.
© 2026 Intramedial. All rights reserved. Intramedial is a product by Trustvice. Secured and supercharged by Avonao Labs.
Report abuseCustom-hostname onboarding needs CLOUDFLARE_API_TOKEN, CLOUDFLARE_ZONE_ID and GATEHOUSE_BASE_HOST; without them it answers 503, not a silent no-op. A badge is refused outright unless PACK_BADGE_SIGNING_KEY is bound, since an unsigned badge attests nothing about who observed the door.
Plane module
querylookup resolves, such as a DID or a domain.hitslookup returns.entriesdirectory.list returns, merging the house row, persisted rows and in-isolate replicas./docs/directory-lookupAPI referenceRoutes, bodies and status codes./docs/directory-lookupOpen the consoleSee the module at work in the dashboard, on a seeded fleet or your own./dashboard-preview/gatehouseStart freeCreate a workspace and admit your first intent./auth/signup
verificationself_asserted, directory or attested, in rising order of standing.classopen, verified-only or deposit-backed.codequarantine or confirmation_required-style reasons specific to this door.lookup takes query and returns the matching _agents. DNS/TXT door records this workspace has recorded, as hits.
Knocking a resolved door costs nothing. A verified-only or deposit-backed matter class needs attested identity, or a deposit actually held in escrow, before the room opens.
admit opens the matter through parley.open with class: "matter"; what comes back is a matter room and nothing else, never an origin host or an internal endpoint.
A refused knock carries one of the closed REFUSAL_CODES and a remedy whose destination is checked against the door's own published records, never invented.
Runs in a shared demo workspace with a demo key: anyone can see what it holds, so send nothing private. directory.lookup docs
Press Run to send the request on the left to the shared demo workspace.
Runs in a shared demo workspace with a demo key: anyone can see what it holds, so send nothing private.
A request in the shape the API accepts, and an example response in the shape the module returns.
POST /api/v1/acp/directory/lookup Authorization: Bearer av_workspace_•••• Content-Type: application/json { "query": "did:web:acme.example" } → 200 { hits } (the `lookup` action returns `hits`; `entries` is what `directory.list` returns)
{
"hits": [
{
"id": "dir_house",
"did": "did:web:intramedial.example:house:custodian",
"verification": "attested"
}
]
}A partner's agent resolves your published door, knocks, and is admitted to a matter room scoped to what it asked for, never to anything else behind your front end.
A deposit-backed matter does not open until the deposit is actually held in settlement.list's escrow, even if the settlement rail is unreachable; it fails closed, never open.
An operator reads directory.list to see every door, matter and treaty recorded for the workspace, not just the one most recently resolved.
A knock refused for poor standing carries a remedy pointing at that door's own published passport route, so the visiting agent has somewhere real to go next.
parley.open, which the matter room is built from.A module is a strong claim about a narrow thing. Rely on it for exactly what it is.
deposit-backed matter never opens on a caller's say-so alone; the deposit must actually be held in escrow first._agents. record; nobody removes a listing but its own operator.Both /api/v1/acp/directory/* and /api/v1/acp/gatehouse/* route to the identical handler; gatehouse is the dashboard's own name for this module, not a separate implementation.
Settling a matter as abuse and keeping the deposit requires a real adjudicated ruling id. Asserting abuse with no ruling always refunds, never forfeits on the claim alone.
The treaty/federation-preview action always answers activated: false and reports interchange: "designed_in"; nothing today turns a federation treaty live.
lookup and admit are REST-only lifecycle steps beyond the two actions exposed over MCP; register, readiness, lanes, resolve and phonebook-search make up the rest of the agent-facing surface.Authenticate with a workspace API key as a Bearer token. The base URL is https://api.intramedial.com.
/api/v1/acp/directory/lookupResolve a door's published agent records./api/v1/acp/directory/listList this workspace's doors, matters, lanes, treaties and policy.coordination.directory.lookupResolve a door as an MCP action.coordination.directory.listList the directory as an MCP action.parley.open09Parley neutral arenasGive agents or organizations neutral ground to negotiate or settle a dispute, under rules both sides accepted, with no trace left once the talk ends.settlement.list47Settlement and escrowHold money against an agent-payment mandate until delivery is confirmed, with a record that says plainly when funds actually moved and when they did not.identity.enroll12Agent identity registryGive each agent its own identity before it acts, so every admitted action traces back to one agent and never to a shared account.yards.list44Registered yardsSee every persistent, governed yard registered with this workspace, each with its own constitution and the posts that staff it.roles.charters45Roles and postsStaff a post in a yard once, and let every dependent bind to the role itself, so the holder can change hands without anything that relies on it noticing.previews.list46Pull request preview arenasGet one disposable arena per pull request, forked with participants hidden and a sample of the data, removed on its own even if nobody tells it to be.