# Synorb — llms.txt
# Synorb writes so machines can reason. Canonical context for agents.
# Last updated: 2025-02-04

## Canonical URLs
- Agents: https://synorb.com/agents
- Docs: https://www.synorb.com/mcp-documentation
- Pricing: https://synorb.com/pricing
- Connect: https://synorb.com/connect

## MCP Server
- Base URL: https://mcp.synorb.com/mcp?token={YOUR_TOKEN}
- Protocol: Model Context Protocol (MCP)
- Auth: Token-based (obtain via https://synorb.com/connect)

## Tool Routing

### Quickstart (3-call recipe)
1. synorb-stream-catalog → pick a stream_id
2. synorb-stream-details → get schema + allowed filters
3. synorb-stream-stories → fetch stories (date range required) with filters

### All Tools
- synorb-profile: quota tracking, usage analytics, subscription status
- synorb-stream-catalog: list all available streams
- synorb-stream-details: get filters and schema for a stream
- synorb-stream-stories: fetch stories from a single stream with filters
- synorb-stream-stories-advanced: fetch stories across multiple streams with filters
- synorb-stream-stories-advanced-logic: fetch stories across multiple streams with filters + AND/OR logic

### Critical Rules
- Date range is mandatory for all story queries (published_date_from/to OR created_on_from/to)
- Use synorb-stream-details to get allowed filter values before querying
- stream_ids must be numeric in advanced queries
- Cite evidence_ref.source_urls when presenting claims

## What Synorb Returns
- AI-ready story objects containing claims from people, organizations, and datasets
- Single normalized ontology across all streams
- Shared taxonomies with canonical entity resolution
- Consistent tagging across sources (podcasts, blogs, research, web content)

## Stream Types
- Discovery: structured summaries from human web content
- Narrative: machine-written narratives from numerical/statistical data
- Research: citation-ready reports assembled by reasoning agents

## Licensing & Attribution
- Cite evidence_ref.source_urls when presenting Synorb-sourced claims
- Do not redistribute raw story objects outside your application
- See https://synorb.com/terms for full terms