KosmoKrator

productivity

Feedbin Lua API for KosmoKrator Agents

Agent-facing Lua documentation and function reference for the Feedbin KosmoKrator integration.

Lua Namespace

Agents call this integration through app.integrations.feedbin.*. Use lua_read_doc("integrations.feedbin") inside KosmoKrator to discover the same reference at runtime.

Call Lua from the Headless CLI

Use kosmo integrations:lua when a shell script, CI job, cron job, or another coding CLI should run a deterministic Feedbin workflow without starting an interactive agent session.

Inline Lua call 
kosmo integrations:lua --eval 'dump(app.integrations.feedbin.check_authentication({}))' --json
Read Lua docs headlessly 
kosmo integrations:lua --eval 'print(docs.read("feedbin"))' --json
kosmo integrations:lua --eval 'print(docs.read("feedbin.check_authentication"))' --json

Workflow file

Put repeatable logic in a Lua file, then execute it with JSON output for the calling process.

workflow.lua 
local feedbin = app.integrations.feedbin
local result = feedbin.check_authentication({})

dump(result)
Run the workflow 
kosmo integrations:lua workflow.lua --json
kosmo integrations:lua workflow.lua --force --json
Namespace note. integrations:lua exposes app.integrations.feedbin, app.mcp.*, docs.*, json.*, and regex.*. Use app.integrations.feedbin.default.* or app.integrations.feedbin.work.* when you configured named credential accounts.

MCP-only Lua

If the script only needs configured MCP servers and does not need Feedbin, use the narrower mcp:lua command.

MCP Lua command 
# Use mcp:lua for MCP-only scripts; use integrations:lua for this integration namespace.
kosmo mcp:lua --eval 'dump(mcp.servers())' --json

Agent-Facing Lua Docs

This is the rendered version of the full Lua documentation exposed to agents when they inspect the integration namespace.

Feedbin

Namespace: feedbin

Feedbin API V2 uses HTTP Basic authentication. Configure username and password; requests default to https://api.feedbin.com/v2.

Subscriptions And Entries

feedbin_subscriptions_create({
  feed_url = "https://example.test/feed.xml"
})

feedbin_entries_list({
  payload = {
    page = 1,
    per_page = 50,
    read = false,
    starred = true,
    mode = "extended"
  }
})

feedbin_feed_entries_list({
  feed_id = "203",
  payload = { page = 2 }
})

Subscription tools cover list/get/create/update/delete, including the POST update fallback. Entry tools cover all entries, feed entries, and single entry lookup.

State, Tags, And Searches

feedbin_unread_entries_create({ unread_entries = { 1, 2, 3 } })
feedbin_unread_entries_delete({ unread_entries = { 1, 2, 3 } })

feedbin_starred_entries_create({ starred_entries = { 1 } })
feedbin_taggings_create({ feed_id = 47, name = "Research" })

feedbin_saved_searches_create({
  name = "Unread security",
  query = "is:unread security"
})

The API also exposes recently read entries, updated entries, icons, OPML imports, and saved pages.

Imports And Raw Calls

feedbin_imports_create expects opml with XML text and sends it as text/xml.

Raw helpers reject absolute URLs:

feedbin_api_get({
  path = "/entries.json",
  payload = { ids = "1,2,3" }
})
Raw agent markdown 
# Feedbin

Namespace: `feedbin`

Feedbin API V2 uses HTTP Basic authentication. Configure `username` and `password`; requests default to `https://api.feedbin.com/v2`.

## Subscriptions And Entries

```lua
feedbin_subscriptions_create({
  feed_url = "https://example.test/feed.xml"
})

feedbin_entries_list({
  payload = {
    page = 1,
    per_page = 50,
    read = false,
    starred = true,
    mode = "extended"
  }
})

feedbin_feed_entries_list({
  feed_id = "203",
  payload = { page = 2 }
})
```

Subscription tools cover list/get/create/update/delete, including the POST update fallback. Entry tools cover all entries, feed entries, and single entry lookup.

## State, Tags, And Searches

```lua
feedbin_unread_entries_create({ unread_entries = { 1, 2, 3 } })
feedbin_unread_entries_delete({ unread_entries = { 1, 2, 3 } })

feedbin_starred_entries_create({ starred_entries = { 1 } })
feedbin_taggings_create({ feed_id = 47, name = "Research" })

feedbin_saved_searches_create({
  name = "Unread security",
  query = "is:unread security"
})
```

The API also exposes recently read entries, updated entries, icons, OPML imports, and saved pages.

## Imports And Raw Calls

`feedbin_imports_create` expects `opml` with XML text and sends it as `text/xml`.

Raw helpers reject absolute URLs:

```lua
feedbin_api_get({
  path = "/entries.json",
  payload = { ids = "1,2,3" }
})
```
Metadata-derived Lua example 
local result = app.integrations.feedbin.check_authentication({})
print(result)

Functions

check_authentication Read

Verify Feedbin Basic auth credentials.

Lua path
app.integrations.feedbin.check_authentication
Full name
feedbin.feedbin_authentication_check
ParameterTypeRequiredDescription
No parameters.
list_subscriptions Read

List Feedbin subscriptions.

Lua path
app.integrations.feedbin.list_subscriptions
Full name
feedbin.feedbin_subscriptions_list
ParameterTypeRequiredDescription
No parameters.
get_subscription Read

Get one subscription.

Lua path
app.integrations.feedbin.get_subscription
Full name
feedbin.feedbin_subscriptions_get
ParameterTypeRequiredDescription
No parameters.
create_subscription Write

Subscribe to a feed URL or website URL.

Lua path
app.integrations.feedbin.create_subscription
Full name
feedbin.feedbin_subscriptions_create
ParameterTypeRequiredDescription
No parameters.
update_subscription Write

Set a custom subscription title.

Lua path
app.integrations.feedbin.update_subscription
Full name
feedbin.feedbin_subscriptions_update
ParameterTypeRequiredDescription
No parameters.
update_subscription_post Write

POST fallback for subscription updates.

Lua path
app.integrations.feedbin.update_subscription_post
Full name
feedbin.feedbin_subscriptions_update_post
ParameterTypeRequiredDescription
No parameters.
delete_subscription Write

Delete a subscription.

Lua path
app.integrations.feedbin.delete_subscription
Full name
feedbin.feedbin_subscriptions_delete
ParameterTypeRequiredDescription
No parameters.
get Read

Get one Feedbin feed.

Lua path
app.integrations.feedbin.get
Full name
feedbin.feedbin_feeds_get
ParameterTypeRequiredDescription
No parameters.
list_entries Read

List entries with filters and pagination.

Lua path
app.integrations.feedbin.list_entries
Full name
feedbin.feedbin_entries_list
ParameterTypeRequiredDescription
No parameters.
list_entries Read

List entries for one feed.

Lua path
app.integrations.feedbin.list_entries
Full name
feedbin.feedbin_feed_entries_list
ParameterTypeRequiredDescription
No parameters.
get_entry Read

Get one entry.

Lua path
app.integrations.feedbin.get_entry
Full name
feedbin.feedbin_entries_get
ParameterTypeRequiredDescription
No parameters.
list_unread_entry_ids Read

List unread entry IDs.

Lua path
app.integrations.feedbin.list_unread_entry_ids
Full name
feedbin.feedbin_unread_entries_list
ParameterTypeRequiredDescription
No parameters.
mark_unread Write

Mark entry IDs as unread.

Lua path
app.integrations.feedbin.mark_unread
Full name
feedbin.feedbin_unread_entries_create
ParameterTypeRequiredDescription
No parameters.
mark_read Write

Mark entry IDs as read.

Lua path
app.integrations.feedbin.mark_read
Full name
feedbin.feedbin_unread_entries_delete
ParameterTypeRequiredDescription
No parameters.
mark_read_post Write

POST fallback for marking read.

Lua path
app.integrations.feedbin.mark_read_post
Full name
feedbin.feedbin_unread_entries_delete_post
ParameterTypeRequiredDescription
No parameters.
list_starred_entry_ids Read

List starred entry IDs.

Lua path
app.integrations.feedbin.list_starred_entry_ids
Full name
feedbin.feedbin_starred_entries_list
ParameterTypeRequiredDescription
No parameters.
star_entries Write

Star entry IDs.

Lua path
app.integrations.feedbin.star_entries
Full name
feedbin.feedbin_starred_entries_create
ParameterTypeRequiredDescription
No parameters.
unstar_entries Write

Unstar entry IDs.

Lua path
app.integrations.feedbin.unstar_entries
Full name
feedbin.feedbin_starred_entries_delete
ParameterTypeRequiredDescription
No parameters.
unstar_entries_post Write

POST fallback for unstarring.

Lua path
app.integrations.feedbin.unstar_entries_post
Full name
feedbin.feedbin_starred_entries_delete_post
ParameterTypeRequiredDescription
No parameters.
list_taggings Read

List taggings.

Lua path
app.integrations.feedbin.list_taggings
Full name
feedbin.feedbin_taggings_list
ParameterTypeRequiredDescription
No parameters.
get_tagging Read

Get one tagging.

Lua path
app.integrations.feedbin.get_tagging
Full name
feedbin.feedbin_taggings_get
ParameterTypeRequiredDescription
No parameters.
create_tagging Write

Create a tagging for a feed.

Lua path
app.integrations.feedbin.create_tagging
Full name
feedbin.feedbin_taggings_create
ParameterTypeRequiredDescription
No parameters.
delete_tagging Write

Delete one tagging.

Lua path
app.integrations.feedbin.delete_tagging
Full name
feedbin.feedbin_taggings_delete
ParameterTypeRequiredDescription
No parameters.
rename_tag Write

Rename a tag.

Lua path
app.integrations.feedbin.rename_tag
Full name
feedbin.feedbin_tags_create
ParameterTypeRequiredDescription
No parameters.
delete_tag Write

Delete a tag.

Lua path
app.integrations.feedbin.delete_tag
Full name
feedbin.feedbin_tags_delete
ParameterTypeRequiredDescription
No parameters.
list_saved_searches Read

List saved searches.

Lua path
app.integrations.feedbin.list_saved_searches
Full name
feedbin.feedbin_saved_searches_list
ParameterTypeRequiredDescription
No parameters.
update_saved_search_post Write

POST fallback for saved-search updates.

Lua path
app.integrations.feedbin.update_saved_search_post
Full name
feedbin.feedbin_saved_searches_update_post
ParameterTypeRequiredDescription
No parameters.
list_recently_read_entry_ids Read

List recently read entry IDs.

Lua path
app.integrations.feedbin.list_recently_read_entry_ids
Full name
feedbin.feedbin_recently_read_entries_list
ParameterTypeRequiredDescription
No parameters.
create_recently_read_entries Write

Create recently-read records.

Lua path
app.integrations.feedbin.create_recently_read_entries
Full name
feedbin.feedbin_recently_read_entries_create
ParameterTypeRequiredDescription
No parameters.
list_updated_entry_ids Read

List updated entry IDs.

Lua path
app.integrations.feedbin.list_updated_entry_ids
Full name
feedbin.feedbin_updated_entries_list
ParameterTypeRequiredDescription
No parameters.
clear_updated_entries Write

Mark updated entries as read.

Lua path
app.integrations.feedbin.clear_updated_entries
Full name
feedbin.feedbin_updated_entries_delete
ParameterTypeRequiredDescription
No parameters.
clear_updated_entries_post Write

POST fallback for clearing updated entries.

Lua path
app.integrations.feedbin.clear_updated_entries_post
Full name
feedbin.feedbin_updated_entries_delete_post
ParameterTypeRequiredDescription
No parameters.
list_icons Read

List feed icons.

Lua path
app.integrations.feedbin.list_icons
Full name
feedbin.feedbin_icons_list
ParameterTypeRequiredDescription
No parameters.
create_import Write

Import OPML XML subscriptions.

Lua path
app.integrations.feedbin.create_import
Full name
feedbin.feedbin_imports_create
ParameterTypeRequiredDescription
No parameters.
list_imports Read

List imports.

Lua path
app.integrations.feedbin.list_imports
Full name
feedbin.feedbin_imports_list
ParameterTypeRequiredDescription
No parameters.
get_import Read

Get import status.

Lua path
app.integrations.feedbin.get_import
Full name
feedbin.feedbin_imports_get
ParameterTypeRequiredDescription
No parameters.
create_page Write

Save a page to Feedbin.

Lua path
app.integrations.feedbin.create_page
Full name
feedbin.feedbin_pages_create
ParameterTypeRequiredDescription
No parameters.
delete_page Write

Delete a saved page.

Lua path
app.integrations.feedbin.delete_page
Full name
feedbin.feedbin_pages_delete
ParameterTypeRequiredDescription
No parameters.
api_get Read

Call a safe relative Feedbin API GET path.

Lua path
app.integrations.feedbin.api_get
Full name
feedbin.feedbin_api_get
ParameterTypeRequiredDescription
No parameters.
api_post Write

Call a safe relative Feedbin API POST path.

Lua path
app.integrations.feedbin.api_post
Full name
feedbin.feedbin_api_post
ParameterTypeRequiredDescription
No parameters.
api_patch Write

Call a safe relative Feedbin API PATCH path.

Lua path
app.integrations.feedbin.api_patch
Full name
feedbin.feedbin_api_patch
ParameterTypeRequiredDescription
No parameters.
api_delete Write

Call a safe relative Feedbin API DELETE path.

Lua path
app.integrations.feedbin.api_delete
Full name
feedbin.feedbin_api_delete
ParameterTypeRequiredDescription
No parameters.