MARS · The open registry
A home for what you build.
A way for the right people—and agents—to find it.
An independent publisher places a signed entry in the catalog. Another agent finds the work it needs.
A place for every capability
Give useful software a structured, signed record. Make its purpose, publisher, and history part of the discovery experience.
The collaborators.
02The useful next step.
03The know-how.
04The intelligence.
05The raw material.
06The bigger picture.
And more: services, organizations, identity roots, and MAP plugin records. Fourteen entry kinds share a common envelope.
Meet the contractThe discovery studio
Start with what you need. Narrow the field. Inspect the publisher, version and metadata behind an entry before taking the next step.
DISCOVER AgentDefinition
ORDER BY published_at DESC, entry_did ASC
LIMIT 12Controls build the query. The examples below are filtered locally.
A place for what you make.
The work. The publisher. The signature.
One accountable starting point.
An illustrated publication envelope
Structured entry content
An entry gives your agent, tool, skill, model, dataset, or service a structured place in the registry. The record makes its capabilities and metadata inspectable.
See how the record worksPublication integrity does not establish that an entry’s claims are true.A history that stays with the work
Software changes. Its record should help you understand how.
An illustrated version journal
A signed entry gives the work a stable identity and a place in the catalog.
Update the record. Resolve the latest version or inspect the earlier one.
Deprecate or revoke work when it is time. Keep its history available to inspect.
Pin a version. Page through the journal. Read the recorded lineage.
Follow an entry’s lifecycleContext before confidence
A name is a beginning. Who published it, who attested to it, and who controls it tell you more.
Inspectable attestations
Attach signed OAS credentials. Inspect their issuer and subject, with expiry and revocation accounted for. A signature establishes origin; the claim still deserves your judgment.
Understand the evidenceBilateral ownership transfer
The current publisher makes a signed, expiring offer. The recipient accepts or declines. A change of ownership is a recorded agreement between both sides.
Explore ownershipFederation, on your terms
Choose your peers. Set the scope.
Keep your authority.
Configure peers and pin their keys. Federation starts with the operator’s choice and is off by default.
Signed envelopes, scoped sync, and durable cursors give each exchange clear boundaries.
When enabled, authorized federated discovery reports which peers succeeded and which could not respond.
A familiar way in
HTTP. JSON. Your favorite language.
Start with a read. Build from there.
Filter complete entries with a bounded MARS-QL query. The response carries entries, a total count, and cursor information.
curl / discover
MARS_URL='https://your-registry.example'
curl --fail "$MARS_URL/v1/discover/marsql" \
-H 'Content-Type: application/json' \
--data '{"query":"DISCOVER AgentDefinition WHERE tags CONTAINS \"research\" ORDER BY published_at DESC LIMIT 10"}'Use your registry URL. Examples are not executed on this page.
Ready to publish? Writes require a signed record, the appropriate capability, and an idempotency key. Start with the complete contract.
The publication flowOpen to inspect. Yours to operate.
Run the Rust reference server with PostgreSQL. Choose the publishers, permissions, and peers that belong in your registry.
Rust-derived schemas and OpenAPI describe 35 operations. HTTP and JSON connect your application to the registry; WebSocket carries catalog events.
Explore the APICapability-scoped writes, idempotent mutations, protected readiness checks, federation visibility, and anchor recovery keep operators in the loop.
Inspect the controlsSigil anchoring is staged. Weave persistence and MARS-S sharding describe the distributed architecture ahead. The reference registry uses PostgreSQL today.
Explore the architecturePart of a bigger, open idea.
The next useful thing
Give your work a record.
Give the next great idea a place to start.