{ "service": "linux_do", "displayName": "Linux DO", "categories": [ "Social", "Developer Tools" ], "authTypes": [ "no_auth" ], "auth": [ { "type": "no_auth" } ], "homepageUrl": "https://linux.do", "actions": [ { "id": "linux_do.list_badge_grants", "service": "linux_do", "name": "list_badge_grants", "description": "List recent grants of a Linux DO badge. RSS endpoint: GET https://linux.do/badges/{id}.rss. Returns 404 when the target is private or not accessible anonymously; a 404 does not necessarily mean the resource does not exist. On a 429/rate-limit error, retry later or fetch the endpoint URL directly from a local network.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "id": { "type": "integer", "minimum": 1, "description": "The numeric badge ID." }, "limit": { "type": "integer", "minimum": 1, "maximum": 100, "description": "The maximum number of items to return. The feed returns a fixed number of items; this truncates the parsed result locally." } }, "additionalProperties": false, "required": [ "id" ], "description": "Input for listing Linux DO badge grants." }, "outputSchema": { "type": "object", "properties": { "feed": { "type": "object", "properties": { "title": { "anyOf": [ { "type": "string", "description": "The feed title, or null when Linux DO omits it." }, { "type": "null" } ] }, "link": { "anyOf": [ { "type": "string", "description": "The feed link, or null when Linux DO omits it." }, { "type": "null" } ] }, "description": { "anyOf": [ { "type": "string", "description": "The feed description, or null when Linux DO omits it." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "RSS channel metadata." }, "grants": { "type": "array", "items": { "type": "object", "properties": { "grantee": { "anyOf": [ { "type": "string", "description": "The display name/username granted the badge, or null." }, { "type": "null" } ] }, "username": { "anyOf": [ { "type": "string", "description": "The username parsed from the grant guid, or null." }, { "type": "null" } ] }, "grantedAt": { "anyOf": [ { "type": "string", "description": "When the badge was granted, or null." }, { "type": "null" } ] }, "grantedBy": { "anyOf": [ { "type": "string", "description": "Who granted the badge, or null." }, { "type": "null" } ] }, "url": { "anyOf": [ { "type": "string", "description": "The grant URL, or null." }, { "type": "null" } ] }, "raw": { "type": "object", "properties": {}, "additionalProperties": true, "description": "The raw parsed RSS item." } }, "additionalProperties": false, "required": [ "raw" ], "description": "A Linux DO badge grant parsed from a badge RSS feed." }, "description": "The badge grants." }, "count": { "type": "integer", "description": "The number of grants returned." } }, "additionalProperties": false, "description": "Output from listing Linux DO badge grants." } }, { "id": "linux_do.list_category_tag_topics", "service": "linux_do", "name": "list_category_tag_topics", "description": "List topics with a tag inside a category. RSS endpoint: GET https://linux.do/tags/c/{slug}/{id}/{tag}.rss. Returns 404 when the target is private or not accessible anonymously; a 404 does not necessarily mean the resource does not exist. On a 429/rate-limit error, retry later or fetch the endpoint URL directly from a local network.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "categorySlug": { "type": "string", "minLength": 1, "description": "The category slug, e.g. \"develop\"." }, "categoryId": { "type": "integer", "minimum": 1, "description": "The numeric category ID." }, "tag": { "type": "string", "minLength": 1, "description": "The tag name/slug, e.g. \"chatgpt\"." }, "limit": { "type": "integer", "minimum": 1, "maximum": 100, "description": "The maximum number of items to return. The feed returns a fixed number of items; this truncates the parsed result locally." } }, "additionalProperties": false, "required": [ "categorySlug", "categoryId", "tag" ], "description": "Input for listing topics with a tag inside a Linux DO category." }, "outputSchema": { "type": "object", "properties": { "feed": { "type": "object", "properties": { "title": { "anyOf": [ { "type": "string", "description": "The feed title, or null when Linux DO omits it." }, { "type": "null" } ] }, "link": { "anyOf": [ { "type": "string", "description": "The feed link, or null when Linux DO omits it." }, { "type": "null" } ] }, "description": { "anyOf": [ { "type": "string", "description": "The feed description, or null when Linux DO omits it." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "RSS channel metadata." }, "topics": { "type": "array", "items": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "integer", "description": "The numeric topic ID parsed from the link/guid, or null." }, { "type": "null" } ] }, "title": { "anyOf": [ { "type": "string", "description": "The topic title, or null." }, { "type": "null" } ] }, "url": { "anyOf": [ { "type": "string", "description": "The Linux DO web URL for the topic, or null." }, { "type": "null" } ] }, "author": { "anyOf": [ { "type": "string", "description": "The topic author (dc:creator), or null." }, { "type": "null" } ] }, "category": { "anyOf": [ { "type": "string", "description": "The category name, or null when absent in the feed." }, { "type": "null" } ] }, "excerpt": { "anyOf": [ { "type": "string", "description": "Plain-text excerpt of the first post, or null." }, { "type": "null" } ] }, "descriptionHtml": { "anyOf": [ { "type": "string", "description": "Rendered HTML description from the feed, or null." }, { "type": "null" } ] }, "pubDate": { "anyOf": [ { "type": "string", "description": "Publication timestamp (ISO 8601), or null." }, { "type": "null" } ] }, "pinned": { "anyOf": [ { "type": "boolean", "description": "Whether the topic is pinned, or null when omitted." }, { "type": "null" } ] }, "closed": { "anyOf": [ { "type": "boolean", "description": "Whether the topic is closed, or null when omitted." }, { "type": "null" } ] }, "archived": { "anyOf": [ { "type": "boolean", "description": "Whether the topic is archived, or null when omitted." }, { "type": "null" } ] }, "raw": { "type": "object", "properties": {}, "additionalProperties": true, "description": "The raw parsed RSS item." } }, "additionalProperties": false, "required": [ "raw" ], "description": "A Linux DO topic parsed from a Discourse RSS feed." }, "description": "The topic summaries." }, "count": { "type": "integer", "description": "The number of topics returned." } }, "additionalProperties": false, "description": "Output from listing Linux DO topics from an RSS feed." } }, { "id": "linux_do.list_category_topics", "service": "linux_do", "name": "list_category_topics", "description": "List topics in a Linux DO category. RSS endpoint: GET https://linux.do/c/{slug}/{id}.rss. Returns 404 when the target is private or not accessible anonymously; a 404 does not necessarily mean the resource does not exist. On a 429/rate-limit error, retry later or fetch the endpoint URL directly from a local network.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "slug": { "type": "string", "minLength": 1, "description": "The category slug, e.g. \"develop\"." }, "id": { "type": "integer", "minimum": 1, "description": "The numeric category ID." }, "limit": { "type": "integer", "minimum": 1, "maximum": 100, "description": "The maximum number of items to return. The feed returns a fixed number of items; this truncates the parsed result locally." } }, "additionalProperties": false, "required": [ "slug", "id" ], "description": "Input for listing topics in a Linux DO category." }, "outputSchema": { "type": "object", "properties": { "feed": { "type": "object", "properties": { "title": { "anyOf": [ { "type": "string", "description": "The feed title, or null when Linux DO omits it." }, { "type": "null" } ] }, "link": { "anyOf": [ { "type": "string", "description": "The feed link, or null when Linux DO omits it." }, { "type": "null" } ] }, "description": { "anyOf": [ { "type": "string", "description": "The feed description, or null when Linux DO omits it." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "RSS channel metadata." }, "topics": { "type": "array", "items": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "integer", "description": "The numeric topic ID parsed from the link/guid, or null." }, { "type": "null" } ] }, "title": { "anyOf": [ { "type": "string", "description": "The topic title, or null." }, { "type": "null" } ] }, "url": { "anyOf": [ { "type": "string", "description": "The Linux DO web URL for the topic, or null." }, { "type": "null" } ] }, "author": { "anyOf": [ { "type": "string", "description": "The topic author (dc:creator), or null." }, { "type": "null" } ] }, "category": { "anyOf": [ { "type": "string", "description": "The category name, or null when absent in the feed." }, { "type": "null" } ] }, "excerpt": { "anyOf": [ { "type": "string", "description": "Plain-text excerpt of the first post, or null." }, { "type": "null" } ] }, "descriptionHtml": { "anyOf": [ { "type": "string", "description": "Rendered HTML description from the feed, or null." }, { "type": "null" } ] }, "pubDate": { "anyOf": [ { "type": "string", "description": "Publication timestamp (ISO 8601), or null." }, { "type": "null" } ] }, "pinned": { "anyOf": [ { "type": "boolean", "description": "Whether the topic is pinned, or null when omitted." }, { "type": "null" } ] }, "closed": { "anyOf": [ { "type": "boolean", "description": "Whether the topic is closed, or null when omitted." }, { "type": "null" } ] }, "archived": { "anyOf": [ { "type": "boolean", "description": "Whether the topic is archived, or null when omitted." }, { "type": "null" } ] }, "raw": { "type": "object", "properties": {}, "additionalProperties": true, "description": "The raw parsed RSS item." } }, "additionalProperties": false, "required": [ "raw" ], "description": "A Linux DO topic parsed from a Discourse RSS feed." }, "description": "The topic summaries." }, "count": { "type": "integer", "description": "The number of topics returned." } }, "additionalProperties": false, "description": "Output from listing Linux DO topics from an RSS feed." } }, { "id": "linux_do.list_group_mentions", "service": "linux_do", "name": "list_group_mentions", "description": "List posts mentioning a Linux DO group. RSS endpoint: GET https://linux.do/g/{name}/mentions.rss. Returns 404 when the target is private or not accessible anonymously; a 404 does not necessarily mean the resource does not exist. On a 429/rate-limit error, retry later or fetch the endpoint URL directly from a local network.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "description": "The Linux DO group name." }, "limit": { "type": "integer", "minimum": 1, "maximum": 100, "description": "The maximum number of items to return. The feed returns a fixed number of items; this truncates the parsed result locally." } }, "additionalProperties": false, "required": [ "name" ], "description": "Input for listing a Linux DO group's mentions." }, "outputSchema": { "type": "object", "properties": { "feed": { "type": "object", "properties": { "title": { "anyOf": [ { "type": "string", "description": "The feed title, or null when Linux DO omits it." }, { "type": "null" } ] }, "link": { "anyOf": [ { "type": "string", "description": "The feed link, or null when Linux DO omits it." }, { "type": "null" } ] }, "description": { "anyOf": [ { "type": "string", "description": "The feed description, or null when Linux DO omits it." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "RSS channel metadata." }, "posts": { "type": "array", "items": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "integer", "description": "The numeric post ID parsed from the guid, or null." }, { "type": "null" } ] }, "topicId": { "anyOf": [ { "type": "integer", "description": "The numeric topic ID parsed from the link, or null." }, { "type": "null" } ] }, "postNumber": { "anyOf": [ { "type": "integer", "description": "The post number within the topic, or null." }, { "type": "null" } ] }, "title": { "anyOf": [ { "type": "string", "description": "The topic title for this post, or null." }, { "type": "null" } ] }, "url": { "anyOf": [ { "type": "string", "description": "The Linux DO web URL for the post, or null." }, { "type": "null" } ] }, "author": { "anyOf": [ { "type": "string", "description": "The post author (dc:creator), or null." }, { "type": "null" } ] }, "excerpt": { "anyOf": [ { "type": "string", "description": "Plain-text excerpt of the post, or null." }, { "type": "null" } ] }, "contentHtml": { "anyOf": [ { "type": "string", "description": "Rendered HTML content from the feed, or null." }, { "type": "null" } ] }, "pubDate": { "anyOf": [ { "type": "string", "description": "Publication timestamp (ISO 8601), or null." }, { "type": "null" } ] }, "raw": { "type": "object", "properties": {}, "additionalProperties": true, "description": "The raw parsed RSS item." } }, "additionalProperties": false, "required": [ "raw" ], "description": "A Linux DO post parsed from a Discourse RSS feed." }, "description": "The post summaries." }, "count": { "type": "integer", "description": "The number of posts returned." } }, "additionalProperties": false, "description": "Output from listing Linux DO posts from an RSS feed." } }, { "id": "linux_do.list_group_posts", "service": "linux_do", "name": "list_group_posts", "description": "List posts by members of a Linux DO group. RSS endpoint: GET https://linux.do/g/{name}/posts.rss. Returns 404 when the target is private or not accessible anonymously; a 404 does not necessarily mean the resource does not exist. On a 429/rate-limit error, retry later or fetch the endpoint URL directly from a local network.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "description": "The Linux DO group name." }, "limit": { "type": "integer", "minimum": 1, "maximum": 100, "description": "The maximum number of items to return. The feed returns a fixed number of items; this truncates the parsed result locally." } }, "additionalProperties": false, "required": [ "name" ], "description": "Input for listing a Linux DO group's posts." }, "outputSchema": { "type": "object", "properties": { "feed": { "type": "object", "properties": { "title": { "anyOf": [ { "type": "string", "description": "The feed title, or null when Linux DO omits it." }, { "type": "null" } ] }, "link": { "anyOf": [ { "type": "string", "description": "The feed link, or null when Linux DO omits it." }, { "type": "null" } ] }, "description": { "anyOf": [ { "type": "string", "description": "The feed description, or null when Linux DO omits it." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "RSS channel metadata." }, "posts": { "type": "array", "items": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "integer", "description": "The numeric post ID parsed from the guid, or null." }, { "type": "null" } ] }, "topicId": { "anyOf": [ { "type": "integer", "description": "The numeric topic ID parsed from the link, or null." }, { "type": "null" } ] }, "postNumber": { "anyOf": [ { "type": "integer", "description": "The post number within the topic, or null." }, { "type": "null" } ] }, "title": { "anyOf": [ { "type": "string", "description": "The topic title for this post, or null." }, { "type": "null" } ] }, "url": { "anyOf": [ { "type": "string", "description": "The Linux DO web URL for the post, or null." }, { "type": "null" } ] }, "author": { "anyOf": [ { "type": "string", "description": "The post author (dc:creator), or null." }, { "type": "null" } ] }, "excerpt": { "anyOf": [ { "type": "string", "description": "Plain-text excerpt of the post, or null." }, { "type": "null" } ] }, "contentHtml": { "anyOf": [ { "type": "string", "description": "Rendered HTML content from the feed, or null." }, { "type": "null" } ] }, "pubDate": { "anyOf": [ { "type": "string", "description": "Publication timestamp (ISO 8601), or null." }, { "type": "null" } ] }, "raw": { "type": "object", "properties": {}, "additionalProperties": true, "description": "The raw parsed RSS item." } }, "additionalProperties": false, "required": [ "raw" ], "description": "A Linux DO post parsed from a Discourse RSS feed." }, "description": "The post summaries." }, "count": { "type": "integer", "description": "The number of posts returned." } }, "additionalProperties": false, "description": "Output from listing Linux DO posts from an RSS feed." } }, { "id": "linux_do.list_hot_topics", "service": "linux_do", "name": "list_hot_topics", "description": "List public hot/trending topics from Linux DO. RSS endpoint: GET https://linux.do/hot.rss. On a 429/rate-limit error, retry later or fetch the endpoint URL directly from a local network.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "limit": { "type": "integer", "minimum": 1, "maximum": 100, "description": "The maximum number of items to return. The feed returns a fixed number of items; this truncates the parsed result locally." } }, "additionalProperties": false, "description": "Input for listing hot Linux DO topics." }, "outputSchema": { "type": "object", "properties": { "feed": { "type": "object", "properties": { "title": { "anyOf": [ { "type": "string", "description": "The feed title, or null when Linux DO omits it." }, { "type": "null" } ] }, "link": { "anyOf": [ { "type": "string", "description": "The feed link, or null when Linux DO omits it." }, { "type": "null" } ] }, "description": { "anyOf": [ { "type": "string", "description": "The feed description, or null when Linux DO omits it." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "RSS channel metadata." }, "topics": { "type": "array", "items": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "integer", "description": "The numeric topic ID parsed from the link/guid, or null." }, { "type": "null" } ] }, "title": { "anyOf": [ { "type": "string", "description": "The topic title, or null." }, { "type": "null" } ] }, "url": { "anyOf": [ { "type": "string", "description": "The Linux DO web URL for the topic, or null." }, { "type": "null" } ] }, "author": { "anyOf": [ { "type": "string", "description": "The topic author (dc:creator), or null." }, { "type": "null" } ] }, "category": { "anyOf": [ { "type": "string", "description": "The category name, or null when absent in the feed." }, { "type": "null" } ] }, "excerpt": { "anyOf": [ { "type": "string", "description": "Plain-text excerpt of the first post, or null." }, { "type": "null" } ] }, "descriptionHtml": { "anyOf": [ { "type": "string", "description": "Rendered HTML description from the feed, or null." }, { "type": "null" } ] }, "pubDate": { "anyOf": [ { "type": "string", "description": "Publication timestamp (ISO 8601), or null." }, { "type": "null" } ] }, "pinned": { "anyOf": [ { "type": "boolean", "description": "Whether the topic is pinned, or null when omitted." }, { "type": "null" } ] }, "closed": { "anyOf": [ { "type": "boolean", "description": "Whether the topic is closed, or null when omitted." }, { "type": "null" } ] }, "archived": { "anyOf": [ { "type": "boolean", "description": "Whether the topic is archived, or null when omitted." }, { "type": "null" } ] }, "raw": { "type": "object", "properties": {}, "additionalProperties": true, "description": "The raw parsed RSS item." } }, "additionalProperties": false, "required": [ "raw" ], "description": "A Linux DO topic parsed from a Discourse RSS feed." }, "description": "The topic summaries." }, "count": { "type": "integer", "description": "The number of topics returned." } }, "additionalProperties": false, "description": "Output from listing Linux DO topics from an RSS feed." } }, { "id": "linux_do.list_latest_posts", "service": "linux_do", "name": "list_latest_posts", "description": "List the latest public posts across Linux DO. RSS endpoint: GET https://linux.do/posts.rss. On a 429/rate-limit error, retry later or fetch the endpoint URL directly from a local network.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "limit": { "type": "integer", "minimum": 1, "maximum": 100, "description": "The maximum number of items to return. The feed returns a fixed number of items; this truncates the parsed result locally." } }, "additionalProperties": false, "description": "Input for listing latest Linux DO posts." }, "outputSchema": { "type": "object", "properties": { "feed": { "type": "object", "properties": { "title": { "anyOf": [ { "type": "string", "description": "The feed title, or null when Linux DO omits it." }, { "type": "null" } ] }, "link": { "anyOf": [ { "type": "string", "description": "The feed link, or null when Linux DO omits it." }, { "type": "null" } ] }, "description": { "anyOf": [ { "type": "string", "description": "The feed description, or null when Linux DO omits it." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "RSS channel metadata." }, "posts": { "type": "array", "items": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "integer", "description": "The numeric post ID parsed from the guid, or null." }, { "type": "null" } ] }, "topicId": { "anyOf": [ { "type": "integer", "description": "The numeric topic ID parsed from the link, or null." }, { "type": "null" } ] }, "postNumber": { "anyOf": [ { "type": "integer", "description": "The post number within the topic, or null." }, { "type": "null" } ] }, "title": { "anyOf": [ { "type": "string", "description": "The topic title for this post, or null." }, { "type": "null" } ] }, "url": { "anyOf": [ { "type": "string", "description": "The Linux DO web URL for the post, or null." }, { "type": "null" } ] }, "author": { "anyOf": [ { "type": "string", "description": "The post author (dc:creator), or null." }, { "type": "null" } ] }, "excerpt": { "anyOf": [ { "type": "string", "description": "Plain-text excerpt of the post, or null." }, { "type": "null" } ] }, "contentHtml": { "anyOf": [ { "type": "string", "description": "Rendered HTML content from the feed, or null." }, { "type": "null" } ] }, "pubDate": { "anyOf": [ { "type": "string", "description": "Publication timestamp (ISO 8601), or null." }, { "type": "null" } ] }, "raw": { "type": "object", "properties": {}, "additionalProperties": true, "description": "The raw parsed RSS item." } }, "additionalProperties": false, "required": [ "raw" ], "description": "A Linux DO post parsed from a Discourse RSS feed." }, "description": "The post summaries." }, "count": { "type": "integer", "description": "The number of posts returned." } }, "additionalProperties": false, "description": "Output from listing Linux DO posts from an RSS feed." } }, { "id": "linux_do.list_latest_topics", "service": "linux_do", "name": "list_latest_topics", "description": "List the latest public topics from Linux DO. RSS endpoint: GET https://linux.do/latest.rss. On a 429/rate-limit error, retry later or fetch the endpoint URL directly from a local network.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "limit": { "type": "integer", "minimum": 1, "maximum": 100, "description": "The maximum number of items to return. The feed returns a fixed number of items; this truncates the parsed result locally." } }, "additionalProperties": false, "description": "Input for listing latest Linux DO topics." }, "outputSchema": { "type": "object", "properties": { "feed": { "type": "object", "properties": { "title": { "anyOf": [ { "type": "string", "description": "The feed title, or null when Linux DO omits it." }, { "type": "null" } ] }, "link": { "anyOf": [ { "type": "string", "description": "The feed link, or null when Linux DO omits it." }, { "type": "null" } ] }, "description": { "anyOf": [ { "type": "string", "description": "The feed description, or null when Linux DO omits it." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "RSS channel metadata." }, "topics": { "type": "array", "items": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "integer", "description": "The numeric topic ID parsed from the link/guid, or null." }, { "type": "null" } ] }, "title": { "anyOf": [ { "type": "string", "description": "The topic title, or null." }, { "type": "null" } ] }, "url": { "anyOf": [ { "type": "string", "description": "The Linux DO web URL for the topic, or null." }, { "type": "null" } ] }, "author": { "anyOf": [ { "type": "string", "description": "The topic author (dc:creator), or null." }, { "type": "null" } ] }, "category": { "anyOf": [ { "type": "string", "description": "The category name, or null when absent in the feed." }, { "type": "null" } ] }, "excerpt": { "anyOf": [ { "type": "string", "description": "Plain-text excerpt of the first post, or null." }, { "type": "null" } ] }, "descriptionHtml": { "anyOf": [ { "type": "string", "description": "Rendered HTML description from the feed, or null." }, { "type": "null" } ] }, "pubDate": { "anyOf": [ { "type": "string", "description": "Publication timestamp (ISO 8601), or null." }, { "type": "null" } ] }, "pinned": { "anyOf": [ { "type": "boolean", "description": "Whether the topic is pinned, or null when omitted." }, { "type": "null" } ] }, "closed": { "anyOf": [ { "type": "boolean", "description": "Whether the topic is closed, or null when omitted." }, { "type": "null" } ] }, "archived": { "anyOf": [ { "type": "boolean", "description": "Whether the topic is archived, or null when omitted." }, { "type": "null" } ] }, "raw": { "type": "object", "properties": {}, "additionalProperties": true, "description": "The raw parsed RSS item." } }, "additionalProperties": false, "required": [ "raw" ], "description": "A Linux DO topic parsed from a Discourse RSS feed." }, "description": "The topic summaries." }, "count": { "type": "integer", "description": "The number of topics returned." } }, "additionalProperties": false, "description": "Output from listing Linux DO topics from an RSS feed." } }, { "id": "linux_do.list_tag_topics", "service": "linux_do", "name": "list_tag_topics", "description": "List topics with a Linux DO tag. RSS endpoint: GET https://linux.do/tag/{tag}.rss. Returns 404 when the target is private or not accessible anonymously; a 404 does not necessarily mean the resource does not exist. On a 429/rate-limit error, retry later or fetch the endpoint URL directly from a local network.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "tag": { "type": "string", "minLength": 1, "description": "The tag name/slug, e.g. \"chatgpt\"." }, "limit": { "type": "integer", "minimum": 1, "maximum": 100, "description": "The maximum number of items to return. The feed returns a fixed number of items; this truncates the parsed result locally." } }, "additionalProperties": false, "required": [ "tag" ], "description": "Input for listing topics with a Linux DO tag." }, "outputSchema": { "type": "object", "properties": { "feed": { "type": "object", "properties": { "title": { "anyOf": [ { "type": "string", "description": "The feed title, or null when Linux DO omits it." }, { "type": "null" } ] }, "link": { "anyOf": [ { "type": "string", "description": "The feed link, or null when Linux DO omits it." }, { "type": "null" } ] }, "description": { "anyOf": [ { "type": "string", "description": "The feed description, or null when Linux DO omits it." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "RSS channel metadata." }, "topics": { "type": "array", "items": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "integer", "description": "The numeric topic ID parsed from the link/guid, or null." }, { "type": "null" } ] }, "title": { "anyOf": [ { "type": "string", "description": "The topic title, or null." }, { "type": "null" } ] }, "url": { "anyOf": [ { "type": "string", "description": "The Linux DO web URL for the topic, or null." }, { "type": "null" } ] }, "author": { "anyOf": [ { "type": "string", "description": "The topic author (dc:creator), or null." }, { "type": "null" } ] }, "category": { "anyOf": [ { "type": "string", "description": "The category name, or null when absent in the feed." }, { "type": "null" } ] }, "excerpt": { "anyOf": [ { "type": "string", "description": "Plain-text excerpt of the first post, or null." }, { "type": "null" } ] }, "descriptionHtml": { "anyOf": [ { "type": "string", "description": "Rendered HTML description from the feed, or null." }, { "type": "null" } ] }, "pubDate": { "anyOf": [ { "type": "string", "description": "Publication timestamp (ISO 8601), or null." }, { "type": "null" } ] }, "pinned": { "anyOf": [ { "type": "boolean", "description": "Whether the topic is pinned, or null when omitted." }, { "type": "null" } ] }, "closed": { "anyOf": [ { "type": "boolean", "description": "Whether the topic is closed, or null when omitted." }, { "type": "null" } ] }, "archived": { "anyOf": [ { "type": "boolean", "description": "Whether the topic is archived, or null when omitted." }, { "type": "null" } ] }, "raw": { "type": "object", "properties": {}, "additionalProperties": true, "description": "The raw parsed RSS item." } }, "additionalProperties": false, "required": [ "raw" ], "description": "A Linux DO topic parsed from a Discourse RSS feed." }, "description": "The topic summaries." }, "count": { "type": "integer", "description": "The number of topics returned." } }, "additionalProperties": false, "description": "Output from listing Linux DO topics from an RSS feed." } }, { "id": "linux_do.list_top_topics", "service": "linux_do", "name": "list_top_topics", "description": "List public top topics from Linux DO for a time period. RSS endpoint: GET https://linux.do/top.rss?period={period} (daily/weekly/monthly/quarterly/yearly/all). On a 429/rate-limit error, retry later or fetch the endpoint URL directly from a local network.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "period": { "type": "string", "enum": [ "daily", "weekly", "monthly", "quarterly", "yearly", "all" ], "description": "The Discourse top-topics period." }, "limit": { "type": "integer", "minimum": 1, "maximum": 100, "description": "The maximum number of items to return. The feed returns a fixed number of items; this truncates the parsed result locally." } }, "additionalProperties": false, "description": "Input for listing top Linux DO topics." }, "outputSchema": { "type": "object", "properties": { "feed": { "type": "object", "properties": { "title": { "anyOf": [ { "type": "string", "description": "The feed title, or null when Linux DO omits it." }, { "type": "null" } ] }, "link": { "anyOf": [ { "type": "string", "description": "The feed link, or null when Linux DO omits it." }, { "type": "null" } ] }, "description": { "anyOf": [ { "type": "string", "description": "The feed description, or null when Linux DO omits it." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "RSS channel metadata." }, "topics": { "type": "array", "items": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "integer", "description": "The numeric topic ID parsed from the link/guid, or null." }, { "type": "null" } ] }, "title": { "anyOf": [ { "type": "string", "description": "The topic title, or null." }, { "type": "null" } ] }, "url": { "anyOf": [ { "type": "string", "description": "The Linux DO web URL for the topic, or null." }, { "type": "null" } ] }, "author": { "anyOf": [ { "type": "string", "description": "The topic author (dc:creator), or null." }, { "type": "null" } ] }, "category": { "anyOf": [ { "type": "string", "description": "The category name, or null when absent in the feed." }, { "type": "null" } ] }, "excerpt": { "anyOf": [ { "type": "string", "description": "Plain-text excerpt of the first post, or null." }, { "type": "null" } ] }, "descriptionHtml": { "anyOf": [ { "type": "string", "description": "Rendered HTML description from the feed, or null." }, { "type": "null" } ] }, "pubDate": { "anyOf": [ { "type": "string", "description": "Publication timestamp (ISO 8601), or null." }, { "type": "null" } ] }, "pinned": { "anyOf": [ { "type": "boolean", "description": "Whether the topic is pinned, or null when omitted." }, { "type": "null" } ] }, "closed": { "anyOf": [ { "type": "boolean", "description": "Whether the topic is closed, or null when omitted." }, { "type": "null" } ] }, "archived": { "anyOf": [ { "type": "boolean", "description": "Whether the topic is archived, or null when omitted." }, { "type": "null" } ] }, "raw": { "type": "object", "properties": {}, "additionalProperties": true, "description": "The raw parsed RSS item." } }, "additionalProperties": false, "required": [ "raw" ], "description": "A Linux DO topic parsed from a Discourse RSS feed." }, "description": "The topic summaries." }, "count": { "type": "integer", "description": "The number of topics returned." } }, "additionalProperties": false, "description": "Output from listing Linux DO topics from an RSS feed." } }, { "id": "linux_do.list_topic_posts", "service": "linux_do", "name": "list_topic_posts", "description": "List posts within a Linux DO topic. RSS endpoint: GET https://linux.do/t/{slug}/{id}.rss (slug defaults to \"topic\"). Returns 404 when the target is private or not accessible anonymously; a 404 does not necessarily mean the resource does not exist. On a 429/rate-limit error, retry later or fetch the endpoint URL directly from a local network.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "topicId": { "type": "integer", "minimum": 1, "description": "The numeric topic ID." }, "slug": { "type": "string", "minLength": 1, "description": "The topic slug; defaults to \"topic\" when omitted." }, "limit": { "type": "integer", "minimum": 1, "maximum": 100, "description": "The maximum number of items to return. The feed returns a fixed number of items; this truncates the parsed result locally." } }, "additionalProperties": false, "required": [ "topicId" ], "description": "Input for listing posts within a Linux DO topic." }, "outputSchema": { "type": "object", "properties": { "feed": { "type": "object", "properties": { "title": { "anyOf": [ { "type": "string", "description": "The feed title, or null when Linux DO omits it." }, { "type": "null" } ] }, "link": { "anyOf": [ { "type": "string", "description": "The feed link, or null when Linux DO omits it." }, { "type": "null" } ] }, "description": { "anyOf": [ { "type": "string", "description": "The feed description, or null when Linux DO omits it." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "RSS channel metadata." }, "posts": { "type": "array", "items": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "integer", "description": "The numeric post ID parsed from the guid, or null." }, { "type": "null" } ] }, "topicId": { "anyOf": [ { "type": "integer", "description": "The numeric topic ID parsed from the link, or null." }, { "type": "null" } ] }, "postNumber": { "anyOf": [ { "type": "integer", "description": "The post number within the topic, or null." }, { "type": "null" } ] }, "title": { "anyOf": [ { "type": "string", "description": "The topic title for this post, or null." }, { "type": "null" } ] }, "url": { "anyOf": [ { "type": "string", "description": "The Linux DO web URL for the post, or null." }, { "type": "null" } ] }, "author": { "anyOf": [ { "type": "string", "description": "The post author (dc:creator), or null." }, { "type": "null" } ] }, "excerpt": { "anyOf": [ { "type": "string", "description": "Plain-text excerpt of the post, or null." }, { "type": "null" } ] }, "contentHtml": { "anyOf": [ { "type": "string", "description": "Rendered HTML content from the feed, or null." }, { "type": "null" } ] }, "pubDate": { "anyOf": [ { "type": "string", "description": "Publication timestamp (ISO 8601), or null." }, { "type": "null" } ] }, "raw": { "type": "object", "properties": {}, "additionalProperties": true, "description": "The raw parsed RSS item." } }, "additionalProperties": false, "required": [ "raw" ], "description": "A Linux DO post parsed from a Discourse RSS feed." }, "description": "The post summaries." }, "count": { "type": "integer", "description": "The number of posts returned." } }, "additionalProperties": false, "description": "Output from listing Linux DO posts from an RSS feed." } }, { "id": "linux_do.list_user_posts", "service": "linux_do", "name": "list_user_posts", "description": "List posts by a Linux DO user. RSS endpoint: GET https://linux.do/u/{username}/activity.rss. Returns 404 when the target is private or not accessible anonymously; a 404 does not necessarily mean the resource does not exist. On a 429/rate-limit error, retry later or fetch the endpoint URL directly from a local network.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "username": { "type": "string", "minLength": 1, "description": "The Linux DO username." }, "limit": { "type": "integer", "minimum": 1, "maximum": 100, "description": "The maximum number of items to return. The feed returns a fixed number of items; this truncates the parsed result locally." } }, "additionalProperties": false, "required": [ "username" ], "description": "Input for listing a Linux DO user's posts." }, "outputSchema": { "type": "object", "properties": { "feed": { "type": "object", "properties": { "title": { "anyOf": [ { "type": "string", "description": "The feed title, or null when Linux DO omits it." }, { "type": "null" } ] }, "link": { "anyOf": [ { "type": "string", "description": "The feed link, or null when Linux DO omits it." }, { "type": "null" } ] }, "description": { "anyOf": [ { "type": "string", "description": "The feed description, or null when Linux DO omits it." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "RSS channel metadata." }, "posts": { "type": "array", "items": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "integer", "description": "The numeric post ID parsed from the guid, or null." }, { "type": "null" } ] }, "topicId": { "anyOf": [ { "type": "integer", "description": "The numeric topic ID parsed from the link, or null." }, { "type": "null" } ] }, "postNumber": { "anyOf": [ { "type": "integer", "description": "The post number within the topic, or null." }, { "type": "null" } ] }, "title": { "anyOf": [ { "type": "string", "description": "The topic title for this post, or null." }, { "type": "null" } ] }, "url": { "anyOf": [ { "type": "string", "description": "The Linux DO web URL for the post, or null." }, { "type": "null" } ] }, "author": { "anyOf": [ { "type": "string", "description": "The post author (dc:creator), or null." }, { "type": "null" } ] }, "excerpt": { "anyOf": [ { "type": "string", "description": "Plain-text excerpt of the post, or null." }, { "type": "null" } ] }, "contentHtml": { "anyOf": [ { "type": "string", "description": "Rendered HTML content from the feed, or null." }, { "type": "null" } ] }, "pubDate": { "anyOf": [ { "type": "string", "description": "Publication timestamp (ISO 8601), or null." }, { "type": "null" } ] }, "raw": { "type": "object", "properties": {}, "additionalProperties": true, "description": "The raw parsed RSS item." } }, "additionalProperties": false, "required": [ "raw" ], "description": "A Linux DO post parsed from a Discourse RSS feed." }, "description": "The post summaries." }, "count": { "type": "integer", "description": "The number of posts returned." } }, "additionalProperties": false, "description": "Output from listing Linux DO posts from an RSS feed." } }, { "id": "linux_do.list_user_topics", "service": "linux_do", "name": "list_user_topics", "description": "List topics created by a Linux DO user. RSS endpoint: GET https://linux.do/u/{username}/activity/topics.rss. Returns 404 when the target is private or not accessible anonymously; a 404 does not necessarily mean the resource does not exist. On a 429/rate-limit error, retry later or fetch the endpoint URL directly from a local network.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "username": { "type": "string", "minLength": 1, "description": "The Linux DO username." }, "limit": { "type": "integer", "minimum": 1, "maximum": 100, "description": "The maximum number of items to return. The feed returns a fixed number of items; this truncates the parsed result locally." } }, "additionalProperties": false, "required": [ "username" ], "description": "Input for listing a Linux DO user's topics." }, "outputSchema": { "type": "object", "properties": { "feed": { "type": "object", "properties": { "title": { "anyOf": [ { "type": "string", "description": "The feed title, or null when Linux DO omits it." }, { "type": "null" } ] }, "link": { "anyOf": [ { "type": "string", "description": "The feed link, or null when Linux DO omits it." }, { "type": "null" } ] }, "description": { "anyOf": [ { "type": "string", "description": "The feed description, or null when Linux DO omits it." }, { "type": "null" } ] } }, "additionalProperties": false, "description": "RSS channel metadata." }, "topics": { "type": "array", "items": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "integer", "description": "The numeric topic ID parsed from the link/guid, or null." }, { "type": "null" } ] }, "title": { "anyOf": [ { "type": "string", "description": "The topic title, or null." }, { "type": "null" } ] }, "url": { "anyOf": [ { "type": "string", "description": "The Linux DO web URL for the topic, or null." }, { "type": "null" } ] }, "author": { "anyOf": [ { "type": "string", "description": "The topic author (dc:creator), or null." }, { "type": "null" } ] }, "category": { "anyOf": [ { "type": "string", "description": "The category name, or null when absent in the feed." }, { "type": "null" } ] }, "excerpt": { "anyOf": [ { "type": "string", "description": "Plain-text excerpt of the first post, or null." }, { "type": "null" } ] }, "descriptionHtml": { "anyOf": [ { "type": "string", "description": "Rendered HTML description from the feed, or null." }, { "type": "null" } ] }, "pubDate": { "anyOf": [ { "type": "string", "description": "Publication timestamp (ISO 8601), or null." }, { "type": "null" } ] }, "pinned": { "anyOf": [ { "type": "boolean", "description": "Whether the topic is pinned, or null when omitted." }, { "type": "null" } ] }, "closed": { "anyOf": [ { "type": "boolean", "description": "Whether the topic is closed, or null when omitted." }, { "type": "null" } ] }, "archived": { "anyOf": [ { "type": "boolean", "description": "Whether the topic is archived, or null when omitted." }, { "type": "null" } ] }, "raw": { "type": "object", "properties": {}, "additionalProperties": true, "description": "The raw parsed RSS item." } }, "additionalProperties": false, "required": [ "raw" ], "description": "A Linux DO topic parsed from a Discourse RSS feed." }, "description": "The topic summaries." }, "count": { "type": "integer", "description": "The number of topics returned." } }, "additionalProperties": false, "description": "Output from listing Linux DO topics from an RSS feed." } } ] }