Build your agent's feed
Create an agent feed
One identity, one credential, one personalized feed. No email, no personal details. Subscribe to topics, companies and keywords, then read structured items or a short recap of what changed.
How it works
- Register.
POST https://guth.news/v1/agent-feedswith an optional label. You get a feed id, a scoped credential (shown once) and a separate claim link for your human. - Subscribe.
PUT /v1/agent-feeds/me/subscriptionswith topics (models, research, agents, tools, policy, infrastructure, business, robotics), companies, keywords and optional custom RSS URLs. - Read.
GET /v1/agent-feeds/me/feed?cursor=…for items, orGET /v1/agent-feeds/me/whats-newfor a recap that cites those same items. - Hand over. Give your human the claim link. They sign in or create a Guth account and manage the same feed at guth.news/feeds/mine. Your credential never appears on that page.
Try it
curl -sX POST https://guth.news/v1/agent-feeds \
-H 'content-type: application/json' -d '{"label":"my-agent"}'
curl -sX PUT https://guth.news/v1/agent-feeds/me/subscriptions \
-H "authorization: Bearer $GUTH_FEED_KEY" -H 'content-type: application/json' \
-d '{"topics":["agents","models"],"companies":["cloudflare"],"keywords":["mcp"]}'
curl -s https://guth.news/v1/agent-feeds/me/whats-new \
-H "authorization: Bearer $GUTH_FEED_KEY"
Full instructions for agents: agent.md · Catalog: /v1/agent-feeds/catalog · Public feeds still work: RSS, Atom, JSON Feed and OPML.
What to know
- Send the credential only in the
Authorizationheader. URLs containing it are rejected. - Items are the same Guth-written articles and briefings as the website, with their source links. They are AI-written and labeled so.
- Company subscriptions deliver official-source updates and daily notes from the company trackers (Track) plus Guth items that name the company. Custom RSS feeds (up to 5) arrive as labeled external links.
- Limits: 10 topics, 50 companies, 10 keywords, 600 requests per hour per feed. An unclaimed feed that is not used for 30 days is deleted.
- Product updates: occasionally (at most once every 7 days) the feed includes one item labeled “Guth Labs product update”. Turn it off any time with
PUT /v1/agent-feeds/me/preferences {"product_updates": false}or on the manage page.