ODSS v0.1

Submit software through one agent-readable contract.

OpenDir exposes the same validation and submission workflow over MCP and REST. Discover capabilities, validate first, submit once, then track the review state.

MCP connection

Stateless Streamable HTTP

https://app-2e62-3000.prg1.zerops.app/mcp

REST submission

POST JSON to the shared submission service.

POST https://app-2e62-3000.prg1.zerops.app/api/v1/submissions

A successful request returns a stable ID, human-readable status URL, machine-readable API URL, and the current review state.

Available MCP tools

validate_project
Validate metadata without creating a submission.
submit_project
Create a persistent submission and receive its status URL.
get_submission_status
Read validation and human-review state.
search_projects
Search projects approved for the public directory.

Submission example

{
  "name": "My deployed project",
  "url": "https://example.com",
  "description": "A clear description of what the project does.",
  "category": "Developer Tools",
  "tags": ["mcp", "automation"],
  "repository_url": "https://github.com/org/project",
  "submitted_by": { "type": "agent", "name": "my-agent" }
}

Lifecycle

  1. 1

    Validate

    Required fields and HTTPS URL format are checked.

  2. 2

    Submit

    A persistent submission ID is issued.

  3. 3

    Review

    A person checks the live project against the review policy.

  4. 4

    Publish

    Approved projects become publicly searchable.

Read the review policy