MCP Server

feed-digest

co.kymac.feeds/feed-digest
Media & Content Search & Research Unavailable MCP 2026-07-28

What this MCP does

Fetches public RSS and Atom feeds and converts them into structured feed items, with prepaid credit and key management.

checkout_credits
Checkout credit pack, rss digest, atom feed, feed items
TEST intent for a pack (POST /credits/checkout). Intent only, returns credits_pending; credits are not granted or spendable until confirm_credits succeeds. Requires a caller key. No live Stripe.
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['pack_id'], 'properties': {'pack_id': {'type': 'string', 'description': 'Pack id from list_credit_packs (e.g. pack_10).'}}}
confirm_credits
Confirm TEST credit purchase, rss digest, atom feed, feed items
Confirm a TEST checkout intent (POST /credits/confirm). This is when credits become granted/spendable (appends credit.purchase with credits_added). TEST only. Synthetic pi_test_… until LAS-212.
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['stripe_payment_intent_id'], 'properties': {'stripe_payment_intent_id': {'type': 'string', 'description': 'PaymentIntent id (pi_test_â\x80¦) from checkout_credits.'}}}
credit_balance
Credit balance, rss digest, atom feed, feed items
Derived prepaid balance for this caller_id (GET /credits/balance).
Read only
Input schema
{'type': 'object', 'properties': {}}
credit_events
Credit ledger events, rss digest, atom feed, feed items
Append-only events for this caller_id (GET /credits/events). Debit reason is digest_success after POST /digest ok:true.
Read only
Input schema
{'type': 'object', 'properties': {}}
digest_feed
Digest a public RSS/Atom URL, rss digest, atom feed, feed items
Fetch a public RSS or Atom feed (POST /digest). Install via GET https://feeds.kymac.co/llms.txt only. Prefer Authorization: Bearer; X-API-Key is an alias. Golden URL https://hnrss.org/frontpage. Compare ok true JSON in llms.txt. First key includes 1 free credit. Quote first with quote_credits (no debit). Debits 1 credit on ok:true (credit.debit reason=digest_success). 200 bodies include credits_burned and credits_remaining. HTTP fails use code/message/retryable/next (error aliases message). 401 next=refresh key. 402: code=insufficient_credits, retryable=false, next=buy credits. Retryable fails use next=retry.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['url'], 'properties': {'url': {'type': 'string', 'description': 'Absolute public http(s) RSS or Atom feed URL. Golden proof URL: https://hnrss.org/frontpage'}}}
health
Health, rss digest, atom feed, feed items
Public readiness (GET /health): billing (test|gated) and runner_ready. No key.
Read only
Input schema
{'type': 'object', 'properties': {}}
issue_key
Issue caller key, rss digest, atom feed, feed items
Mint a caller key (POST /keys). Bot install starts at GET https://feeds.kymac.co/llms.txt (sole advertised entry). Secret fdg_… is returned once. Prefer Authorization: Bearer; X-API-Key is an alias. First issue grants 1 free credit (credit.grant reason=first_key). Quote cost with quote_credits before digest_feed.
Input schema
{'type': 'object', 'properties': {}}
list_credit_packs
List credit packs, rss digest, atom feed, feed items
Prepaid TEST packs (GET /credits/packs). checkout_credits is intent only; credits grant after confirm_credits.
Read only
Input schema
{'type': 'object', 'properties': {}}
quote_credits
Quote credit cost, rss digest, atom feed, feed items
Dry-run cost for an op without debit (GET /credits/quote?op=digest). Returns cost, balance, and would_succeed.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'op': {'type': 'string', 'description': 'Operation to quote. Defaults to digest.'}}}
revoke_key
Revoke caller key, rss digest, atom feed, feed items
Invalidate the presented secret (POST /keys/revoke). Same id is revoked; old secret then fails 401 invalid_api_key. Prefer Authorization: Bearer; X-API-Key is an alias only. No ops file-edit.
Destructive
Input schema
{'type': 'object', 'properties': {}}
rotate_key
Rotate caller key, rss digest, atom feed, feed items
Replace the presented secret (POST /keys/rotate). Same id/caller_id and credits. New fdg_… is returned once. Old secret then fails 401 invalid_api_key. Prefer Authorization: Bearer; X-API-Key is an alias only. No ops file-edit.
Input schema
{'type': 'object', 'properties': {}}
verify_key
Verify caller key, rss digest, atom feed, feed items
Confirm FEED_DIGEST_API_KEY or Authorization: Bearer (GET /keys/verify). X-API-Key is an alias only. Does not echo the secret.
Read only
Input schema
{'type': 'object', 'properties': {}}
Added
health
Sept. 19, 2026, 2:40 a.m.
Added
digest_feed
Sept. 19, 2026, 2:40 a.m.
Added
credit_events
Sept. 19, 2026, 2:40 a.m.
Added
credit_balance
Sept. 19, 2026, 2:40 a.m.
Added
quote_credits
Sept. 19, 2026, 2:40 a.m.
Added
confirm_credits
Sept. 19, 2026, 2:40 a.m.
Added
checkout_credits
Sept. 19, 2026, 2:40 a.m.
Added
list_credit_packs
Sept. 19, 2026, 2:40 a.m.
Added
revoke_key
Sept. 19, 2026, 2:40 a.m.
Added
rotate_key
Sept. 19, 2026, 2:40 a.m.
Added
verify_key
Sept. 19, 2026, 2:40 a.m.
Added
issue_key
Sept. 19, 2026, 2:40 a.m.