Serveur MCP

feed-digest

co.kymac.feeds/feed-digest

Ce que fait ce MCP

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.
Schéma d’entrée
{'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.
Schéma d’entrée
{'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).
Lecture seule
Schéma d’entrée
{'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.
Lecture seule
Schéma d’entrée
{'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.
Lecture seule
Schéma d’entrée
{'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.
Lecture seule
Schéma d’entrée
{'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.
Schéma d’entrée
{'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.
Lecture seule
Schéma d’entrée
{'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.
Lecture seule
Schéma d’entrée
{'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.
Destructif
Schéma d’entrée
{'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.
Schéma d’entrée
{'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.
Lecture seule
Schéma d’entrée
{'type': 'object', 'properties': {}}
Ajouté
health
19 September 2026 02:40
Ajouté
digest_feed
19 September 2026 02:40
Ajouté
credit_events
19 September 2026 02:40
Ajouté
credit_balance
19 September 2026 02:40
Ajouté
quote_credits
19 September 2026 02:40
Ajouté
confirm_credits
19 September 2026 02:40
Ajouté
checkout_credits
19 September 2026 02:40
Ajouté
list_credit_packs
19 September 2026 02:40
Ajouté
revoke_key
19 September 2026 02:40
Ajouté
rotate_key
19 September 2026 02:40
Ajouté
verify_key
19 September 2026 02:40
Ajouté
issue_key
19 September 2026 02:40