# MARS documentation > The source-backed registry reference. Protocol, discovery, signatures, and operations for developers and agents. Full text: https://docs.mars.glass/llms-full.txt Docs MCP: https://docs.mars.glass/api/mcp Skill: https://docs.mars.glass/skill.md # Docs - [MARS documentation](https://docs.mars.glass/index.md): Discover, publish, and verify agent registry records. - Protocol - [Registry architecture](https://docs.mars.glass/protocol/architecture.md): Durable PostgreSQL storage and clearly bounded integrations. - [Attestations and reports](https://docs.mars.glass/protocol/attestations.md): Signed claims, issuer policy, and registry reports. - [Registry-local bonds](https://docs.mars.glass/protocol/bonds.md): Bond metadata, validation, and the external settlement boundary. - [Entry format and signatures](https://docs.mars.glass/protocol/entry-format.md): The exact wire shape, 14 entry kinds, hashes, and signing profile. - [Federation and trust](https://docs.mars.glass/protocol/federation.md): Selected peers, signed envelopes, and bounded convergence. - [Identity and publishers](https://docs.mars.glass/protocol/identities.md): DIDs, publisher control, and optional human-root lineage. - [What is MARS?](https://docs.mars.glass/protocol/introduction.md): The registry contract and its implementation boundaries. - [Versions, revocation, and transfers](https://docs.mars.glass/protocol/lifecycle.md): Registry lifecycle and explicit ownership handoff. - [Lineage and relationships](https://docs.mars.glass/protocol/lineage.md): Read parentage without confusing it with authorization. - [Publish a signed entry](https://docs.mars.glass/protocol/publishing.md): Prepare an authorized, idempotent registry mutation. - [Query your first registry](https://docs.mars.glass/protocol/quickstart.md): A complete read-only discovery and resolution workflow. - MARS-QL - [Attestation filters](https://docs.mars.glass/marsql/attestation-joins.md): Filter attestation counts without inventing joins or trust scores. - [Query cookbook](https://docs.mars.glass/marsql/cookbook.md): Practical bounded queries using implemented operators. - [Grammar and supported fields](https://docs.mars.glass/marsql/grammar.md): Syntax implemented by the checked-in parser and query planner. - [Lineage filters](https://docs.mars.glass/marsql/lineage-traversal.md): Filter recorded lineage, then resolve the evidence explicitly. - [MARS-QL](https://docs.mars.glass/marsql/overview.md): A bounded query language over complete registry records. - HTTP guides - [Attestation and report APIs](https://docs.mars.glass/api/attestations.md): Read signed evidence and submit authorized claims. - [Discovery endpoints](https://docs.mars.glass/api/discover.md): Structured, MARS-QL, and bounded federated discovery. - [Entries and versions](https://docs.mars.glass/api/entries.md): Read complete records and perform signed lifecycle mutations. - [Errors and retry behavior](https://docs.mars.glass/api/errors.md): Treat contract failures, authorization, and uncertain delivery separately. - [WebSocket events](https://docs.mars.glass/api/events.md): Real subscription behavior and its current limitations. - [Federation API](https://docs.mars.glass/api/federation.md): Signed peer traffic and operator control. - [Lineage endpoint](https://docs.mars.glass/api/lineage.md): Retrieve lineage associated with a registered entry. - [HTTP API overview](https://docs.mars.glass/api/overview.md): 35 operations generated from the canonical OpenAPI contract. - API reference - [API reference](https://docs.mars.glass/api-reference.md): All 35 operations from the canonical MARS v1 OpenAPI document. - [Abandon anchor](https://docs.mars.glass/api-reference/abandon_anchor.md) - [Retry anchor](https://docs.mars.glass/api-reference/retry_anchor.md) - [Provision bond](https://docs.mars.glass/api-reference/provision_bond.md) - [Federation peer status](https://docs.mars.glass/api-reference/federation_peer_status.md) - [Get anchors](https://docs.mars.glass/api-reference/get_anchors.md): Returns a stable keyset page of durable provider-neutral anchor intents, immutable receipts, and the current registry projection. - [Create attestation](https://docs.mars.glass/api-reference/create_attestation.md): Verifies and separately stores a canonical OAS Verifiable Credential. - [Get attestations](https://docs.mars.glass/api-reference/get_attestations.md) - [Logout](https://docs.mars.glass/api-reference/logout.md) - [Session](https://docs.mars.glass/api-reference/session.md) - [Siws challenge](https://docs.mars.glass/api-reference/siws_challenge.md) - [Siws verify](https://docs.mars.glass/api-reference/siws_verify.md) - [Get bond](https://docs.mars.glass/api-reference/get_bond.md) - [Discover](https://docs.mars.glass/api-reference/discover.md) - [Discover federated](https://docs.mars.glass/api-reference/discover_federated.md) - [Discover marsql](https://docs.mars.glass/api-reference/discover_marsql.md) - [Create entry](https://docs.mars.glass/api-reference/create_entry.md) - [Delete entry](https://docs.mars.glass/api-reference/delete_entry.md) - [Get entry](https://docs.mars.glass/api-reference/get_entry.md) - [Update entry](https://docs.mars.glass/api-reference/update_entry.md) - [Get entry lineage](https://docs.mars.glass/api-reference/get_entry_lineage.md) - [List entry versions](https://docs.mars.glass/api-reference/list_entry_versions.md) - [Get entry version](https://docs.mars.glass/api-reference/get_entry_version.md) - [Federation discover](https://docs.mars.glass/api-reference/federation_discover.md): Serves a typed MARS-QL query only after signed-envelope verification, replay protection, and active agreement authorization. - [List federation peers](https://docs.mars.glass/api-reference/list_federation_peers.md) - [Update federation peer](https://docs.mars.glass/api-reference/update_federation_peer.md) - [Federation sync](https://docs.mars.glass/api-reference/federation_sync.md): Returns local changes only after OAS service identity, JCS Ed25519 envelope, durable nonce, and active agreement verification. - [Health](https://docs.mars.glass/api-reference/health.md) - [Deep health](https://docs.mars.glass/api-reference/deep_health.md) - [List registries alias](https://docs.mars.glass/api-reference/list_registries_alias.md): Compatibility alias with the exact response body of GET /v1/federation/peers. - [Create report](https://docs.mars.glass/api-reference/create_report.md): Records a report whose reporter is derived from Principal. - [Get transfer offer](https://docs.mars.glass/api-reference/get_transfer_offer.md) - [Accept transfer offer](https://docs.mars.glass/api-reference/accept_transfer_offer.md) - [Decline transfer offer](https://docs.mars.glass/api-reference/decline_transfer_offer.md) - [Transfer entry](https://docs.mars.glass/api-reference/transfer_entry.md): Creates a signed, expiring offer without changing entry ownership. - [Websocket](https://docs.mars.glass/api-reference/websocket.md) - Operators - [Anchor intents and activation](https://docs.mars.glass/operators/anchoring.md): A durable adapter boundary with governed external activation. - [Authentication and capabilities](https://docs.mars.glass/operators/authentication.md): SIWS sessions, scoped authority, and operator trust. - [Operate federation](https://docs.mars.glass/operators/federation.md): Configure peers, signing, agreements, and bounded synchronization. - [Run a durable registry](https://docs.mars.glass/operators/production.md): Production configuration, storage, readiness, and trust. - [Backup and recovery](https://docs.mars.glass/operators/recovery.md): Verify durable ledgers and recover without inventing success. - Rust libraries - [Rust libraries](https://docs.mars.glass/libraries.md): All three workspace crates and their public module boundaries. - mars-protocol - [mars-protocol](https://docs.mars.glass/libraries/mars-protocol.md): Wire contracts, publisher signing, hashing, lifecycle, query AST, federation, and event types. - [mars-protocol · anchor](https://docs.mars.glass/libraries/mars-protocol/anchor.md): Public declarations and documentation for mars-protocol::anchor. - [mars-protocol · anchoring](https://docs.mars.glass/libraries/mars-protocol/anchoring.md): Public declarations and documentation for mars-protocol::anchoring. - [mars-protocol · api](https://docs.mars.glass/libraries/mars-protocol/api.md): Public declarations and documentation for mars-protocol::api. - [mars-protocol · bonds](https://docs.mars.glass/libraries/mars-protocol/bonds.md): Public declarations and documentation for mars-protocol::bonds. - [mars-protocol · contract](https://docs.mars.glass/libraries/mars-protocol/contract.md): Public declarations and documentation for mars-protocol::contract. - [mars-protocol · entry](https://docs.mars.glass/libraries/mars-protocol/entry.md): Public declarations and documentation for mars-protocol::entry. - [mars-protocol · errors](https://docs.mars.glass/libraries/mars-protocol/errors.md): Public declarations and documentation for mars-protocol::errors. - [mars-protocol · events](https://docs.mars.glass/libraries/mars-protocol/events.md): Public declarations and documentation for mars-protocol::events. - [mars-protocol · federation](https://docs.mars.glass/libraries/mars-protocol/federation.md): Public declarations and documentation for mars-protocol::federation. - [mars-protocol · hash](https://docs.mars.glass/libraries/mars-protocol/hash.md): Public declarations and documentation for mars-protocol::hash. - [mars-protocol · lifecycle](https://docs.mars.glass/libraries/mars-protocol/lifecycle.md): Public declarations and documentation for mars-protocol::lifecycle. - [mars-protocol · marsql](https://docs.mars.glass/libraries/mars-protocol/marsql.md): Public declarations and documentation for mars-protocol::marsql. - [mars-protocol · relationships](https://docs.mars.glass/libraries/mars-protocol/relationships.md): Public declarations and documentation for mars-protocol::relationships. - [mars-protocol · crate](https://docs.mars.glass/libraries/mars-protocol/root.md): Wire contracts, publisher signing, hashing, lifecycle, query AST, federation, and event types. - [mars-protocol · signature](https://docs.mars.glass/libraries/mars-protocol/signature.md): Public declarations and documentation for mars-protocol::signature. - [mars-protocol · types](https://docs.mars.glass/libraries/mars-protocol/types.md): Public declarations and documentation for mars-protocol::types. - Marsql - [mars-protocol · marsql::ast](https://docs.mars.glass/libraries/mars-protocol/marsql/ast.md): Public declarations and documentation for mars-protocol::marsql::ast. - [mars-protocol · marsql::evaluator](https://docs.mars.glass/libraries/mars-protocol/marsql/evaluator.md): Public declarations and documentation for mars-protocol::marsql::evaluator. - [mars-protocol · marsql::parser](https://docs.mars.glass/libraries/mars-protocol/marsql/parser.md): Public declarations and documentation for mars-protocol::marsql::parser. - mars-server - [mars-server](https://docs.mars.glass/libraries/mars-server.md): Registry HTTP server, authorization, durable storage, query planning, federation, and anchor outbox. - [mars-server · anchor](https://docs.mars.glass/libraries/mars-server/anchor.md): Public declarations and documentation for mars-server::anchor. - [mars-server · api](https://docs.mars.glass/libraries/mars-server/api.md): Public declarations and documentation for mars-server::api. - [mars-server · auth](https://docs.mars.glass/libraries/mars-server/auth.md): Public declarations and documentation for mars-server::auth. - [mars-server · bond](https://docs.mars.glass/libraries/mars-server/bond.md): Public declarations and documentation for mars-server::bond. - [mars-server · config](https://docs.mars.glass/libraries/mars-server/config.md): Public declarations and documentation for mars-server::config. - [mars-server · contracts](https://docs.mars.glass/libraries/mars-server/contracts.md): Public declarations and documentation for mars-server::contracts. - [mars-server · discovery](https://docs.mars.glass/libraries/mars-server/discovery.md): Public declarations and documentation for mars-server::discovery. - [mars-server · error](https://docs.mars.glass/libraries/mars-server/error.md): Public declarations and documentation for mars-server::error. - [mars-server · federation](https://docs.mars.glass/libraries/mars-server/federation.md): Public declarations and documentation for mars-server::federation. - [mars-server · middleware](https://docs.mars.glass/libraries/mars-server/middleware.md): Public declarations and documentation for mars-server::middleware. - [mars-server · observability](https://docs.mars.glass/libraries/mars-server/observability.md): Public declarations and documentation for mars-server::observability. - [mars-server · production](https://docs.mars.glass/libraries/mars-server/production.md): Public declarations and documentation for mars-server::production. - [mars-server · crate](https://docs.mars.glass/libraries/mars-server/root.md): Registry HTTP server, authorization, durable storage, query planning, federation, and anchor outbox. - [mars-server · search](https://docs.mars.glass/libraries/mars-server/search.md): Public declarations and documentation for mars-server::search. - [mars-server · store](https://docs.mars.glass/libraries/mars-server/store.md): Public declarations and documentation for mars-server::store. - [mars-server · validation](https://docs.mars.glass/libraries/mars-server/validation.md): Public declarations and documentation for mars-server::validation. - Anchor - [mars-server · anchor::config](https://docs.mars.glass/libraries/mars-server/anchor/config.md): Public declarations and documentation for mars-server::anchor::config. - [mars-server · anchor::sigil](https://docs.mars.glass/libraries/mars-server/anchor/sigil.md): Public declarations and documentation for mars-server::anchor::sigil. - [mars-server · anchor::test_adapter](https://docs.mars.glass/libraries/mars-server/anchor/test_adapter.md): Public declarations and documentation for mars-server::anchor::test_adapter. - Api - [mars-server · api::rest](https://docs.mars.glass/libraries/mars-server/api/rest.md): Public declarations and documentation for mars-server::api::rest. - [mars-server · api::websocket](https://docs.mars.glass/libraries/mars-server/api/websocket.md): Public declarations and documentation for mars-server::api::websocket. - Auth - [mars-server · auth::adapters](https://docs.mars.glass/libraries/mars-server/auth/adapters.md): Public declarations and documentation for mars-server::auth::adapters. - [mars-server · auth::challenge_store](https://docs.mars.glass/libraries/mars-server/auth/challenge_store.md): Public declarations and documentation for mars-server::auth::challenge_store. - [mars-server · auth::handlers](https://docs.mars.glass/libraries/mars-server/auth/handlers.md): Public declarations and documentation for mars-server::auth::handlers. - [mars-server · auth::principal](https://docs.mars.glass/libraries/mars-server/auth/principal.md): Public declarations and documentation for mars-server::auth::principal. - [mars-server · auth::registry](https://docs.mars.glass/libraries/mars-server/auth/registry.md): Public declarations and documentation for mars-server::auth::registry. - [mars-server · auth::session_store](https://docs.mars.glass/libraries/mars-server/auth/session_store.md): Public declarations and documentation for mars-server::auth::session_store. - Adapters - [mars-server · auth::adapters::siws](https://docs.mars.glass/libraries/mars-server/auth/adapters/siws.md): Public declarations and documentation for mars-server::auth::adapters::siws. - Federation - [mars-server · federation::discovery](https://docs.mars.glass/libraries/mars-server/federation/discovery.md): Public declarations and documentation for mars-server::federation::discovery. - [mars-server · federation::envelope](https://docs.mars.glass/libraries/mars-server/federation/envelope.md): Public declarations and documentation for mars-server::federation::envelope. - [mars-server · federation::policy](https://docs.mars.glass/libraries/mars-server/federation/policy.md): Public declarations and documentation for mars-server::federation::policy. - [mars-server · federation::service](https://docs.mars.glass/libraries/mars-server/federation/service.md): Public declarations and documentation for mars-server::federation::service. - [mars-server · federation::transport](https://docs.mars.glass/libraries/mars-server/federation/transport.md): Public declarations and documentation for mars-server::federation::transport. - [mars-server · federation::worker](https://docs.mars.glass/libraries/mars-server/federation/worker.md): Public declarations and documentation for mars-server::federation::worker. - Middleware - [mars-server · middleware::auth](https://docs.mars.glass/libraries/mars-server/middleware/auth.md): Public declarations and documentation for mars-server::middleware::auth. - Store - [mars-server · store::memory](https://docs.mars.glass/libraries/mars-server/store/memory.md): Public declarations and documentation for mars-server::store::memory. - [mars-server · store::postgres](https://docs.mars.glass/libraries/mars-server/store/postgres.md): Public declarations and documentation for mars-server::store::postgres. - [mars-server · store::sharded_memory](https://docs.mars.glass/libraries/mars-server/store/sharded_memory.md): Public declarations and documentation for mars-server::store::sharded_memory. - Validation - [mars-server · validation::resolver](https://docs.mars.glass/libraries/mars-server/validation/resolver.md): Public declarations and documentation for mars-server::validation::resolver. - mars-shard - [mars-shard](https://docs.mars.glass/libraries/mars-shard.md): MARS-S prototype affinity, topology, shadow copies, resolution, and cross-shard coordination. - [mars-shard · affinity](https://docs.mars.glass/libraries/mars-shard/affinity.md): Public declarations and documentation for mars-shard::affinity. - [mars-shard · cross_shard](https://docs.mars.glass/libraries/mars-shard/cross_shard.md): Public declarations and documentation for mars-shard::cross_shard. - [mars-shard · error](https://docs.mars.glass/libraries/mars-shard/error.md): Public declarations and documentation for mars-shard::error. - [mars-shard · gal](https://docs.mars.glass/libraries/mars-shard/gal.md): Public declarations and documentation for mars-shard::gal. - [mars-shard · lifecycle](https://docs.mars.glass/libraries/mars-shard/lifecycle.md): Public declarations and documentation for mars-shard::lifecycle. - [mars-shard · resolution](https://docs.mars.glass/libraries/mars-shard/resolution.md): Public declarations and documentation for mars-shard::resolution. - [mars-shard · crate](https://docs.mars.glass/libraries/mars-shard/root.md): MARS-S prototype affinity, topology, shadow copies, resolution, and cross-shard coordination. - [mars-shard · shadow](https://docs.mars.glass/libraries/mars-shard/shadow.md): Public declarations and documentation for mars-shard::shadow. - [mars-shard · topology](https://docs.mars.glass/libraries/mars-shard/topology.md): Public declarations and documentation for mars-shard::topology. - Contract artifacts - [Contract downloads](https://docs.mars.glass/reference/artifacts.md): Exact OpenAPI, 64 schemas, signing vectors, and source provenance. - Tools - [Inspect anchor intents](https://docs.mars.glass/cli/anchor.md): Current tools and HTTP workflows; no fictional client CLI. - [Discover with HTTP](https://docs.mars.glass/cli/discover.md): Current tools and HTTP workflows; no fictional client CLI. - [Federation operations](https://docs.mars.glass/cli/federate.md): Current tools and HTTP workflows; no fictional client CLI. - [Run a MARS-QL query](https://docs.mars.glass/cli/marsql.md): Current tools and HTTP workflows; no fictional client CLI. - [Server and operator tools](https://docs.mars.glass/cli/overview.md): The three binaries actually provided by the MARS workspace. - [Resolve with HTTP](https://docs.mars.glass/cli/resolve.md): Current tools and HTTP workflows; no fictional client CLI. - [Subscribe over WebSocket](https://docs.mars.glass/cli/subscribe.md): Current tools and HTTP workflows; no fictional client CLI. - [Verify contracts and ledgers](https://docs.mars.glass/cli/verify.md): Current tools and HTTP workflows; no fictional client CLI. - MARS-S prototype - [Resolution cascade](https://docs.mars.glass/sharding/cascade.md): Feature-gated prototype; separate from the durable production reference. - [Global anchor layer](https://docs.mars.glass/sharding/global-anchor-layer.md): Feature-gated prototype; separate from the durable production reference. - [MARS-S status](https://docs.mars.glass/sharding/overview.md): Feature-gated prototype; separate from the durable production reference. - [Regional shard layer](https://docs.mars.glass/sharding/regional-shard-layer.md): Feature-gated prototype; separate from the durable production reference. - [Topology and lifecycle](https://docs.mars.glass/sharding/topology.md): Feature-gated prototype; separate from the durable production reference. - [Documentation for agents](https://docs.mars.glass/agents.md): Choose narrow context, verified contracts, and read-only documentation tools.