streamable-httpMITupdated 10d ago
smry is the official command-line client for the credential-free smry Public Reader. It reads an exact public article, PDF, or supported YouTube URL as clean text or structured JSON with stable paragraph anchors.
What can you do with smry Public Reader?
smry CLI
smry is the official command-line client for the credential-free
smry Public Reader. It reads an exact public article, PDF,
or supported YouTube URL as clean text or structured JSON with stable paragraph
anchors.
Install
brew install mrmps/smry/smry
Use
smry https://example.com/article
smry --json https://example.com/report.pdf
smry --query "key findings" https://example.com/article
smry --lines 90-95 https://example.com/article
Run smry --help for the complete option list.
Agent skill
Install the official skills for source-grounded reading workflows:
bunx skills add https://github.com/mrmps/homebrew-smry --skill smry compare-sources verify-citations
The skills cover direct reading, multi-source comparison, and claim or citation verification. They choose between the public MCP, HTTP API, and CLI, preserve stable paragraph citations, and treat retrieved content as untrusted data.
The CLI sends only the exact source URL and the options you provide to
https://r.smry.ai/api/v1/read. Do not send private URLs, cookies,
authorization headers, subscriber credentials, or personal documents.
Public MCP server
Agents can call the same credential-free reader through the remote
Streamable HTTP MCP server at https://r.smry.ai/mcp. Its official registry
metadata is versioned in server.json; the endpoint provides a
source-reading tool plus documentation resources and requires no account or
secret.
Verify
bash -n bin/smry
./tests/smry-cli.test.sh
./tests/mcp-registry.test.sh
License
MIT
Install
Add smry Public Reader to your client. Pick the one you use.
claude mcp add --transport http smry-public-reader https://r.smry.ai/mcpcodex mcp add smry-public-reader --url https://r.smry.ai/mcp{
"mcpServers": {
"smry-public-reader": {
"url": "https://r.smry.ai/mcp"
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
{
"servers": {
"smry-public-reader": {
"type": "http",
"url": "https://r.smry.ai/mcp"
}
}
}Add to `.vscode/mcp.json` in your workspace.
{
"mcpServers": {
"smry-public-reader": {
"url": "https://r.smry.ai/mcp"
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"smry-public-reader": {
"serverUrl": "https://r.smry.ai/mcp"
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
Score
39 / 100
Incomplete
- Documentation17/25
- Maintenance19/25
- Trust13/20
- Capability0/15
- Install experience12/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 2 days ago
- Has a release history
- Repository is not archived
- Licensed MIT
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 0 tool(s) documented
- Provides prompt templates
- Provides resources
- 6 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint — no local install
Version history
| Versions | Published |
|---|---|
| 1.0.0Latest | Aug 29, 2026 |