Choose a connection by the task
The REST reference currently describes post-history and search retrieval as limited to one request per second, with the applicable account/stream constraints. Use sockets for continuous delivery rather than turning the history endpoint into an aggressive polling loop.
| Find candidate streams | MCP search and get_stream | Check source description, ACTIVE state and API access metadata. |
| Load accessible stored posts | REST history | Confirm following/access, requested date bounds and returned pagination. |
| Ingest incoming events | WebSocket on-stream-post | Confirm reader key and streamIds; record event envelopes. |
| Ask a question inside an accessible stream | MCP search_stream_posts | Confirm OAuth posts permission and distinguish post text from catalog metadata. |
No matching records. Try a broader search.
Validate the integration in stages
First inspect a stream publicly and verify that its named sources match your job. Then create an account and confirm the stream entitlement, allowed usage and API access. Keep these as separate checks: a publicly visible description does not establish that your reader can retrieve its posts.
Next obtain a reader key for a server-side integration, or complete OAuth for an MCP client. Save a small permitted sample and map source URL and time fields into the Python gate. Missing metadata must have a review policy before you start writing model prompts.
Accept the workflow only after a real reader test
- Receive an event from the intended stream and persist its source references.
- Exercise a disconnect and compare the recovered records with the saved interval.
- Check a draft against original documents and record unsupported statements.
- Confirm source licences and redistribution terms for your actual output.
- Keep delivery and model-quality evidence separate; the public MCP probe tests neither.
What this publication has and has not established
The deterministic intake script was run against labelled fixtures. The public Synoptic MCP discovery operations were also exercised. The authenticated REST reader, WebSocket subscription and model-drafting stage are documented examples requiring your account; they were not tested in the publication run.
If you need a particular publisher or retention period, ask Synoptic to confirm it before building around it. This guide makes no promise of a specific paid newswire, a measured delivery latency or a summary-accuracy benchmark.
Source notes
- Synoptic REST reference ↗
Stored posts, source metadata, date bounds and retrieval constraints.
- Synoptic WebSocket subscriptions ↗
Live event envelope, streamIds and limited lastPosts catch-up.
- Synoptic MCP documentation ↗
Tool behavior, OAuth and stream discovery versus post search.
The Synoptic workflow
Create a Synoptic account
Confirm your source streams and access before wiring the reader.
Create a Synoptic account