# Synorb — llms.txt # Machine-readable intelligence for AI agents and reasoning systems. # Last updated: 2026-03-10 > Synorb writes so machines can reason. We deliver structured stories via streams > under a single ontology with common taxonomies and stable IDs, enabling AI > systems to traverse the substrate of contextual knowledge we produce. 500+ > streams delivering temporal intelligence on-demand. ## Machine-Readable Specs - OpenAPI: https://synorb.com/openapi.json - Extended docs: https://synorb.com/llms-full.txt - AI Plugin: https://synorb.com/.well-known/ai-plugin.json - Human docs: https://synorb.com/docs ## Quick Start Get free credentials at https://synorb.com/credentials — trial credentials emailed instantly (1,000 manifests/month). Or programmatically: curl -s https://synorb.com/connect Returns API key, secret, MCP token, and connection config. No signup form. No email. No human approval. ## Key Glossary Record Ingested content payload — one article, podcast, data release Story Processed record: claims extracted, tags resolved, quality scored Claim Atomic assertion (15–50 per record). Type + confidence + evidence Signal Structured claims for reasoning systems completing workflows Brief Structured narrative for reasoning systems delivering info to human operators Stream Filtered delivery view — content organized by theme Tag Resolved entity: person, organization, place, or data source Topic Curated thematic category from Synorb's topic taxonomy Manifest Delivery unit dispatching Briefs, Signals and Records by subscription Digest Grouping of manifests. Synorb Digests ($5/mo) or User Digests (org-built) Domain One of 12 canonical knowledge domains ## MCP Server (Recommended for Agents) Auth: token in the URL query parameter. This token is MCP-only — it does NOT work on the REST API. Use `api-key` + `secret` headers for REST API calls instead. Add to your MCP config: { "mcpServers": { "synorb": { "url": "https://mcp.synorb.com/sse?token=YOUR_TOKEN" } } } 17 tools available. Content gated by plan at execution time. ## After Connecting — What To Do First Once MCP tools are active, immediately call these two (in parallel if possible): 1. synorb-account → returns plan_name, manifests_per_month, manifests_remaining 2. synorb-stream-catalog → returns all streams with pagination.total_count Then greet the user: "Connection established! I can access {total_count} streams on Synorb and read up to {manifests_per_month} manifests per month ({manifests_remaining} remaining). What should we read first?" Once the user picks a topic or stream: 3. synorb-stream-details(stream_id) → get filters and body sections 4. synorb-stream-signals(stream_id) → structured claims (or synorb-stream-briefs for narratives) Date ranges are required on story queries. Default to last 7 days if user doesn't specify. For REST API agents (Codex, Copilot, Lovable, Bolt, v0), same pattern: 1. GET /account → plan, quota 2. GET /streams?page_size=5 → stream catalog 3. GET /streams/{id}/signals?published_date_from=YYYY-MM-DD&published_date_to=YYYY-MM-DD Same greeting: tell the user how many streams and how much quota, then ask what to read. ## REST API (Base URL: https://api.synorb.com) Auth: send `api-key` and `secret` headers with every request. MCP tokens (`access_token`) are NOT accepted on the REST API — use them only with the MCP server. ### Core Endpoints (3-call quickstart) 1. GET /streams — List all streams. Filter by home_domain. Returns volume metrics. 2. GET /streams/{id} — Stream details: title, status, stream_class, filters, source_channels, volume metrics. 3. GET /streams/{id}/manifests — Record + Signal + Brief triplets in one call. ### Content Endpoints GET /streams/{id}/manifests Record + Signal + Brief triplets (primary endpoint) Filter: tag_ids, tag_type, published_date_from/to, page, page_size GET /streams/{id}/signals Signals only (structured claims) GET /streams/{id}/briefs Briefs only (structured narratives) GET /streams/{id}/records Records only (Enterprise) GET /manifests/{record_id} Single manifest by record ID Platform/Firehose Endpoints (dedicated granular access by manifest ID): GET /signal/{manifest_id} Signal by manifest ID (Platform only) GET /brief/{manifest_id} Brief by manifest ID (Platform only) GET /record/{manifest_id} Record by manifest ID (Platform only) Manifest access is gated by plan: Signal — Structured claims extraction All plans Brief — Structured narrative summary All plans Record — Structured content objects, enriched with entity tags and topics Enterprise only ### Common Query Parameters published_date_from date Start date (YYYY-MM-DD) published_date_to date End date (YYYY-MM-DD) page int 0-indexed page number page_size int Max 200, default 50 ### Account & Management GET /account Profile, plan, quota GET /keys Active credentials POST /keys/regenerate New credentials GET /usage Usage history ### Digest Builder (Pro Developer | Startup | Enterprise) Custom groupings of manifests. Build with stream IDs, dynamic filters, or both. POST /digests Create digest (stream_ids + filter_spec) GET /digests List your org's digests GET /digests/{id} Digest detail + resolved streams PUT /digests/{id} Update digest DELETE /digests/{id} Soft-delete POST /digests/{id}/activate Re-enable deactivated digest POST /digests/{id}/deactivate Pause digest POST /digests/{id}/streams Add streams to digest DELETE /digests/{id}/streams Remove streams from digest POST /digests/preview-filter Preview matching streams GET /digests/{id}/manifests Manifests across all digest streams GET /digests/{id}/briefs Briefs across all digest streams GET /digests/{id}/signals Signals across all digest streams filter_spec dimensions: topic, tag, domain, source, source_type, claim_type, media_format ### Ontology Sync (Enterprise) Map Synorb tags and topics to your internal identifiers. Once synced, every delivery payload includes your IDs automatically. POST /ontology/sync Create or update a sync (object_type, object_id, external_id, external_name, labels) DELETE /ontology/sync/{id} Remove a sync (soft delete) GET /ontology/syncs List active syncs (filter by object_type, label) GET /ontology/tags Search tag catalog (fuzzy match) GET /ontology/topics Browse topic catalog POST /ontology/labels Create custom label GET /ontology/labels List label definitions Python SDK: pip install synorb client = Synorb(api_key="KEY", api_secret="SECRET") client.ontology.sync(tag_id=1234, external_id="CRM-TSLA-001") client.ontology.unsync(tag_id=1234) ### Synorb Digests (Marketplace — $5/mo each, or free on Startup/Enterprise) Pre-curated intelligence bundles. 5,000 manifests/month hard cap per digest. Startup and Enterprise plans get free access — "Add" instead of "Subscribe". GET /api/digests Browse public catalog (no auth) POST /digests/subscribe Subscribe to a Synorb Digest ($5/mo via Stripe) POST /digests/synorb/{id}/add Add Synorb Digest (Startup/Enterprise — free) DELETE /digests/synorb/{id}/remove Remove Synorb Digest from account GET /digests/synorb List added Synorb Digests GET /digests/{id}/manifests Fetch manifests (same endpoint as user digests) POST /digests/unsubscribe Cancel a Synorb Digest subscription ### Webhooks (Startup | Enterprise) GET /webhooks List webhooks POST /webhooks Register (returns signing secret). Optional stream_id or digest_id to scope. POST /webhooks/{id}/test Send test event GET /webhooks/{id}/logs Delivery history POST /webhooks/{id}/disable Disable (reversible) POST /webhooks/{id}/reactivate Re-enable DELETE /webhooks/{id} Delete permanently Events: manifest.matched — Real-time. A new manifest was routed to a subscribed stream. stream.created — On publish. A new stream went live on the platform. stream.removed — On action. A stream was permanently deactivated. Payload includes reason. stream.unpublished — On action. A stream was temporarily unpublished (may return). Payload includes reason. digest.new_content — Real-time. A new manifest was routed to a stream in your digest. digest.created — On action. A Synorb Digest was added to your account. digest.updated — On action. A digest was updated. Payload includes message describing changes. digest.removed — On action. A Synorb Digest was removed from your account. HMAC: X-Synorb-Signature: sha256= Retry: 3 attempts (0s, 60s, 300s). 10 failures = auto-disable. ### S3 Export (Startup | Enterprise) GET /backfill/grants List export grants POST /backfill/{grant_id}/download Presigned S3 URL (7-day validity) POST /export/trigger Trigger bulk export ### Billing GET /plans Available plans with pricing GET /subscription Current subscription POST /subscription/change Upgrade/downgrade POST /subscription/cancel Cancel POST /subscription/reactivate Reactivate ## WebSocket Firehose (Platform product) Connect: wss://ws.synorb.com Auth: {"type":"auth","token":"YOUR_TOKEN"} Subscribe: {"type":"subscribe","streams":[id],"domains":["..."],"tag_types":["..."]} Stories pushed as they arrive. ## Data Model ### Three Delivery Formats (bundled in manifests) Signal Structured claims extraction (15-50 atomic assertions per record) body contains: claims (array), entity_details (array), topics (array), domain_classification (object) Brief Structured narrative summary (headline, summary, body, body_markdown, sentiment, significance) body contains: key_insights (array of strings), notable_quotes (array of objects), entity_details (array of objects), topics (array of strings), domain_classification (object) body_markdown: Markdown-rendered brief (## Key Insights, ## Notable Quotes, etc.) Audio manifests (media_format="audio") include 4 additional body fields: actionable_takeaways Array of strings — actionable recommendations guest_details Array of {name, title, affiliation} for guests/performers cross_promotion Array of strings — mentions of other shows/products/platforms cultural_relevance String or null — why this content matters in the current context Audio body_markdown additionally renders: ## Actionable Takeaways, ## Guest or Performer Details, ## Cross-Promotion, ## Cultural Relevance Record Structured content objects, enriched with entity tags and topics (Enterprise only) IMPORTANT: entity_details is always an ARRAY of objects (list of dicts), not a dict. Each object has: { "tag_type": "Organization|Person|Place|Topic", "tag_value": "string" } This field appears in signal.body, brief.body, and record.extra_data.extraction. ### Claim Properties claim_type publication | announcement | disclosure | remarks | data | analysis | event confidence stated | implied | inferred | measured evidence direct_quote | paraphrase | derived | observed ### Source Types person Individual (founder, researcher, executive) organization Company, publication, government body, institution data Statistical or data feed (indices, filings, datasets) ### Media Formats text Articles, blog posts, reports, press releases audio Podcasts, earnings calls, conference talks video YouTube, keynotes, TV interviews social Tweets/X posts, threads data Statistical releases, datasets, indices transcript Earnings call transcripts regulatory SEC filings, government disclosures ### Tag Types (Ontology) person Named individual organization Company, institution, government body place Geographic location topic Subject matter data Data source or dataset ### Stream Types Discovery Structured summaries from human web content (news, blogs, reports) Narrative Machine-written narratives from numerical/statistical data sources Research Analysis reports written for machine consumption ### 12 Canonical Domains arts-culture-entertainment economics-business-work engineering-technology everyday-life-practical-knowledge health-medicine language-literature life-environment people-biography-history physical-sciences-mathematics places-geography society-law-government universe-earth ### Quality Scores significance 0–100. How important the content is within its domain. sentiment -1.0 to 1.0. Directional sentiment of content. ## Plans & Pricing STREAMS PRODUCT Free $0 1,000 manifests/mo MCP Server + REST API. Signals + Briefs. Vibe Coder $10–$18/mo 10,000 manifests/mo MCP Server + REST API. Signals + Briefs. Pro Developer $50–$90/mo 100,000 manifests/mo MCP Server + REST API + Digest Builder + Synorb Digests. Signals + Briefs. Startup $250–$450/mo 1,000,000 manifests/mo MCP Server + REST API + Digest Builder + Synorb Digests + Webhooks + S3. Signals + Briefs. Enterprise Contact us Custom MCP Server + REST API + Digest Builder + Synorb Digests + Webhooks + Sync Ontology + Support. Signals + Briefs + Records. Platform (Firehose) Contact us Custom All channels + WebSocket. Sync Ontology. Signals + Briefs + Records. MANIFEST ACCESS Signal Structured claims extraction All plans Brief Structured narrative summary All plans Record Structured content objects, enriched with entity tags and topics Enterprise only FEATURE GATING MCP Server All plans REST API All plans Digest Builder Pro Developer | Startup | Enterprise Synorb Digests Pro Developer | Startup | Enterprise (free) Webhooks Startup | Enterprise S3 Export Startup | Enterprise Records Enterprise only Sync Ontology Enterprise only Support Enterprise only REFRESH CADENCE Manifests are produced continuously but delivered in batches at 0 UTC. Monthly Batch on the 1st at 0 UTC. Last month's manifests available on the 1st. Weekly Batch on Monday at 0 UTC. Last week's manifests available Monday. Daily Batch at 0 UTC. Yesterday's manifests available today. Continuous Real-time. Manifests available as produced. Free: monthly only. Vibe Coder | Pro Developer | Startup: choose monthly, weekly, or daily (price varies by tier). Enterprise: continuous. OVERAGE Free: hard cap. Vibe Coder | Pro Developer | Startup: $0.001/manifest. Enterprise: negotiated. PAYMENT Free: none. Vibe Coder | Pro Developer: Credit Card. Startup: ACH. Enterprise: Wire. Synorb Digests: Pre-curated bundles. $5/mo each with 5,000 manifest/month cap. ## Response Headers X-Synorb-Quota-Limit Monthly manifest limit X-Synorb-Quota-Used Manifests consumed this period X-Synorb-Quota-Remaining Manifests remaining X-Synorb-Period Current billing period X-Synorb-Content-Level Your content access level (1, 2, or 3) ## MCP Tools Reference ### Stream & Content Tools synorb-stream-catalog List all streams with metadata and volume metrics synorb-stream-details Filters, schema, allowed values for a stream synorb-stream-signals Structured claims for reasoning systems synorb-stream-briefs Structured narratives for reasoning systems synorb-stream-records Structured content objects, enriched with entity tags and topics (Enterprise only) synorb-stream-manifests Signal + Brief on all plans. Record at Enterprise. synorb-account Account info, plan, quota, access level ### Digest Tools synorb-digests List all digests (both Synorb and User types) synorb-stream-digest Fetch manifests from any digest ### Ontology Tools synorb-tag-search Fuzzy search across all tags synorb-topics-browse Browse topic hierarchy synorb-related-tags Find co-occurring tags in recent manifests synorb-tag-sync Create or update a sync synorb-tag-unsync Remove a sync synorb-sync-list List active syncs with filters synorb-label-create Create custom label synorb-labels-list List organization's labels ## Licensing & Attribution - Cite source URLs when presenting Synorb-sourced claims - Do not redistribute raw content objects outside your application - Terms: https://synorb.com/terms - Contact: team@synorb.com