{"$schema":"https://schema.org","@context":"https://schema.org","@id":"https://embeddedsemantics.com/answers#faq","@type":"FAQPage","citation":"https://embeddedsemantics.com/answers","creator":{"@type":"Organization","identifier":"https://embeddedsemantics.com/#organization","name":"Embedded Semantics","url":"https://embeddedsemantics.com/"},"dateModified":"2026-09-02","description":"Canonical answers for agent connection, resolution, representation, and authorization boundaries.","downstreamAuthorization":false,"downstreamSideEffects":0,"indexingGuarantee":false,"isBasedOn":"https://embeddedsemantics.com/answers","license":"https://embeddedsemantics.com/citation","mainEntity":[{"@id":"https://embeddedsemantics.com/answers#what-is-embedded-semantics","@type":"Question","acceptedAnswer":{"@type":"Answer","citation":"https://embeddedsemantics.com/answers#what-is-embedded-semantics","text":"Embedded Semantics is a governed expression-resolution service. It maps an exact expression to a published ConceptCode only when the resolver returns a structurally valid resolved outcome."},"name":"What is Embedded Semantics?"},{"@id":"https://embeddedsemantics.com/answers#how-do-agents-connect","@type":"Question","acceptedAnswer":{"@type":"Answer","citation":"https://embeddedsemantics.com/answers#how-do-agents-connect","text":"Agents can use the direct JSON API or the stateless MCP endpoint. Start with GET /api/v1/agent/connect for API directions or POST /mcp for MCP discovery."},"name":"How do AI agents connect?"},{"@id":"https://embeddedsemantics.com/answers#when-is-a-conceptcode-accepted","@type":"Question","acceptedAnswer":{"@type":"Answer","citation":"https://embeddedsemantics.com/answers#when-is-a-conceptcode-accepted","text":"An agent may accept exactly one ConceptCode only from a structurally valid resolved response. Unknown, ambiguous, malformed, request-error, service-error, and transport-error outcomes accept none."},"name":"When may an agent accept a ConceptCode?"},{"@id":"https://embeddedsemantics.com/answers#does-resolution-authorize-actions","@type":"Question","acceptedAnswer":{"@type":"Answer","citation":"https://embeddedsemantics.com/answers#does-resolution-authorize-actions","text":"No. Semantic identity and downstream authorization are separate. The resolver and MCP tools do not execute downstream actions."},"name":"Does semantic resolution authorize downstream actions?"},{"@id":"https://embeddedsemantics.com/answers#how-do-machines-discover-the-apis","@type":"Question","acceptedAnswer":{"@type":"Answer","citation":"https://embeddedsemantics.com/answers#how-do-machines-discover-the-apis","text":"Read /.well-known/api-catalog for the RFC 9727 Linkset catalog, /openapi.json for the direct API contract, or /mcp-server.json for the deployment-specific MCP manifest."},"name":"How do machines discover the public APIs?"},{"@id":"https://embeddedsemantics.com/answers#are-machine-representations-byte-stable","@type":"Question","acceptedAnswer":{"@type":"Answer","citation":"https://embeddedsemantics.com/answers#are-machine-representations-byte-stable","text":"Owned JSON, Markdown, Linkset, and discovery representations use deterministic UTF-8 bytes with strong content-derived validators. Nonce-bearing HTML is private and no-store instead."},"name":"Are machine-readable representations byte-stable?"},{"@id":"https://embeddedsemantics.com/answers#how-can-an-agent-verify-discovery","@type":"Question","acceptedAnswer":{"@type":"Answer","citation":"https://embeddedsemantics.com/answers#how-can-an-agent-verify-discovery","text":"Read /.well-known/embedded-semantics-discovery.json, select a route from its representation receipt, and compare the returned Content-Location, media type, strong ETag, and Repr-Digest with the exact response bytes. Verify deployment identity through an independently authenticated release channel."},"name":"How can an agent verify a discovery representation?"}],"name":"Embedded Semantics answers","publisher":{"@type":"Organization","identifier":"https://embeddedsemantics.com/#organization","name":"Embedded Semantics","url":"https://embeddedsemantics.com/"},"rankingGuarantee":false,"release":"v22-wip","semanticAssignment":false,"url":"https://embeddedsemantics.com/answers"}
