Discover and use SAM·TLDR

Machine-readable discovery

• Agent manifest/.well-known/sam-tldr-agent.json
• Public tools and schemas/api/v1/agent/tools
• Scoped tools and schemas/api/v1/user/tools
• Ontology and interface coverage/api/v1/ontology
• Source graph schema/api/v1/ontology/schema
• Canonical contracts/api/v1/contracts
• OpenAPI/api/v1/openapi.json
• MCP discovery/api/v1/mcp/discovery
• Feed schemas and source semantics/api/v1/feeds/schema
• Canonical JSON feed/feed.json
• Canonical RSS feed/feed.xml

Invoke public tools

Send a JSON invocation to /api/v1/agent/invoke. The discovery document lists tool arguments, output contracts and limits.

{
  "name": "investigate_opportunities",
  "arguments": {
    "query": {
      "text": "cyber services",
      "limit": 3,
      "unknownPolicy": "exclude"
    }
  }
}

Rust CLI and MCP

sam-tldr discover
sam-tldr tools
sam-tldr ontology
sam-tldr schemas
sam-tldr invoke --url https://samtldr.com
sam-tldr mcp

invoke reads one JSON object from stdin. Local invocation and MCP require DATABASE_URL. Remote invocation targets the website origin once deployed. SAM_TLDR_BEARER_TOKEN enables explicitly scoped owner tools through /api/v1/user/invoke. Keep credentials out of URLs and command arguments.

Investigations and saved workflows

Investigate anonymously, or connect a scoped credential to advance, cancel and resume a durable workflow. Compare source revisions in a saved brief. Unknown facts and incomplete evidence remain visible.